Proprietà IVSSItem.Items

Articolo
08/22/2007

Ottiene un riferimento del tipo IVSSItems a un oggetto che rappresenta l'insieme di tutti gli elementi secondari (file e progetti) di un progetto.

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

Sintassi

'Dichiarazione
ReadOnly Property Items ( _
    <InAttribute> <OptionalAttribute> Optional IncludeDeleted As Boolean = False _
) As IVSSItems
'Utilizzo
Dim instance As IVSSItem
Dim IncludeDeleted As Boolean
Dim value As IVSSItems

value = instance.Items(IncludeDeleted)

IVSSItems Items [
    [OptionalAttribute] [InAttribute] bool IncludeDeleted
] { get; }

property IVSSItems^ Items [bool] {
    IVSSItems^ get ([InAttribute] [OptionalAttribute] bool IncludeDeleted);
}

/** @property */
IVSSItems get_Items (/** @attribute InAttribute() */ /** @attribute OptionalAttribute() */ boolean IncludeDeleted)

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

Parametri

Valore proprietà

Un riferimento del tipo IVSSItems a un oggetto che rappresenta l'insieme di tutti gli elementi secondari (file e progetti) di un progetto.

Note

[IDL]

HRESULT Items ([in,defaultvalue(0)]boolean IncludeDeleted, [out,retval]IVSSItems **ppIItems);

Ciascun progetto di Visual SourceSafe può contenere al massimo quattro tipi di oggetti:

file eliminati
file non eliminati
progetti eliminati
progetti non eliminati.

Vengono restituiti solo gli elementi di livello immediatamente inferiore a un progetto. Questa proprietà non funziona in modo ricorsivo.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà Items per visualizzare tutti gli elementi non eliminati di un progetto.

Per eseguire l'esempio:

Creare un progetto $/TestFolder/.

Il progetto $/TestFolder/ contiene: file1.txt, file2.txt, Subfolder1, Subfolder2.

[C#]

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

public class IVSSTest
{
    public static void Main()
    {
        string testFolder = "$/TestFolder";
        
        // 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 project object.
        IVSSItem vssFolder = vssDatabase.get_VSSItem(testFolder, false);

        // Display folder contents.
        Console.Write("{0} contains:", vssFolder.Spec);
        foreach(IVSSItem vssItem in vssFolder.get_Items(false))
            Console.Write(" {0}", vssItem.Name);
    }
}

Output:

$/TestFolder contains: file1.txt file2.txt Subfolder1 Subfolder2

[Visual Basic]

Imports System
Imports Microsoft.VisualStudio.SourceSafe.Interop

Module IVSSTest

    Public Sub Main()

        Dim testFolder As String = "$/TestFolder"

        ' Create a VSSDatabase object.
        Dim vssDatabase As IVSSDatabase = 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 project object.
        Dim vssFolder As IVSSItem = vssDatabase.VSSItem(testFolder, False)

        ' Display project contents.
        Console.Write("{0} contains:", vssFolder.Spec)
        Dim vssItem As IVSSItem
        For Each vssItem In vssFolder.Items(False)
            Console.Write(" {0}", vssItem.Name)
        Next vssItem

    End Sub

End Module