Proprietà IVSSItem.Version

Articolo
08/22/2007

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)

Sintassi

'Dichiarazione
ReadOnly Property Version ( _
    <InAttribute> <OptionalAttribute> Version As Object _
) As VSSItem
'Utilizzo
Dim instance As IVSSItem
Dim Version As Object
Dim value As VSSItem

value = instance.Version(Version)

VSSItem Version [
    [OptionalAttribute] [InAttribute] Object Version
] { get; }

property VSSItem^ Version [Object^] {
    VSSItem^ get ([InAttribute] [OptionalAttribute] Object^ Version);
}

/** @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.

Note

[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"

Esempio

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