Proprietà IVSSItem.Version

Ottiene un riferimento del tipo IVSSItem a un oggetto che rappresenta un'istanza specifica di IVSSVersion per un file o un progetto nell'insieme IVSSVersions.

Spazio dei nomi: Microsoft.VisualStudio.SourceSafe.Interop
Assembly: Microsoft.VisualStudio.SourceSafe.Interop (in microsoft.visualstudio.sourcesafe.interop.dll)

VSSItem Version [
	[OptionalAttribute] [InAttribute] Object Version
] { get; }
/** @property */
VSSItem get_Version (/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ Object Version)

JScript supporta l'utilizzo di proprietà indicizzate ma non la dichiarazione di nuove.

Parametri

Valore proprietà

Un riferimento del tipo IVSSItem a un oggetto che rappresenta una versione IVSSVersion specifica di un file o di un progetto nell'insieme IVSSVersions.

[IDL]

HRESULT Version ([in,optional]VARIANT Version, [out,retval]IVSSItem **ppIItem);

L'insieme IVSSVersions ha una numerazione che inizia da uno.

Il parametro Version può essere rappresentato in uno dei seguenti formati:

Stringa di data valida

Una versione di un file o di un progetto relativa alla data specifica

"12/15/03"

Stringa numerica valida

Una versione numerata di un file o di un progetto

"7"

Etichetta

Una versione a cui non è associata né una data né un numero

"Rel1"

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà Version per recuperare una versione specifica del file utilizzando un indice numerico. Per eseguire l'esempio:

  • Creare un progetto $/TestFolder/.

    $/TestFolder contiene il file test.txt, per il quale sono disponibili quattro versioni.

[C#]

using System;
using Microsoft.VisualStudio.SourceSafe.Interop;

public class IVSSTest
{
    public static void Main()
    {
        // Create a VSSDatabase object.
        IVSSDatabase vssDatabase = new VSSDatabase();

        // Open a VSS database using network name 
        // for automatic user login.
        vssDatabase.Open(@"C:\VSSTestDB\srcsafe.ini", 
                         Environment.UserName, ""); 

        // Get an IVSSItem reference to the file object.
        IVSSItem vssFile = 
                 vssDatabase.get_VSSItem("$/TestFolder/test.txt", false);

        // Use default (0) setting for get_Versions(0)
        Console.Write("{0} has following versions:", vssFile.Spec);
        foreach(IVSSVersion vssVersion in vssFile.get_Versions(0))
            Console.Write(" {0}", vssVersion.VersionNumber);
 
        // Each version can be accessed through 1-based index.
        IVSSItem vssFileVersion = vssFile.get_Version(2);
        Console.WriteLine("\nIndex 2 retrieves version {0}", 
                          vssFileVersion.VersionNumber);
    }
}

Output:

$/TestFolder/test.txt has following versions: 4 3 2 1

Index 2 retrieves version 2

Imports System
Imports Microsoft.VisualStudio.SourceSafe.Interop

Module IVSSTest

    Public Sub Main()

        ' Create a VSSDatabase object.
        Dim vssDatabase As New VSSDatabase

        ' Open a VSS database using automatic login for security.
        vssDatabase.Open("C:\VSSTestDB\srcsafe.ini", Environment.UserName, "")

        ' Create IVSSItem references to the test files.
        Dim vssFile As IVSSItem = _
                       vssDatabase.VSSItem("$/TestFolder/test.txt", False)

        ' Default (0) settings should be used unless there is 
        ' some particular reason to override them.
        Console.Write("{0} has following versions:", vssFile.Spec)
        For Each vssVersion As IVSSVersion In vssFile.Versions(0)
            Console.Write(" {0}", vssVersion.VersionNumber)
        Next vssVersion

        ' Each version can be accessed through 1-based index.
        Dim vssFileVersion As IVSSItem = vssFile.Version(2)
        Console.WriteLine(vbLf + "Index 2 retrieves version {0}", _
                          vssFileVersion.VersionNumber)

    End Sub 'Main

End Module

Output:

$/TestFolder/test.txt has following versions: 4 3 2 1

Index 2 retrieves version 2

Mostra: