Collection Classe

Definizione

public ref class Collection sealed : System::Collections::IList

public ref class Collection sealed : System::Collections::IList, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class Collection : System.Collections.IList

[System.Serializable]
public sealed class Collection : System.Collections.IList, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type Collection = class
    interface ICollection
    interface IEnumerable
    interface IList

type Collection = class
    interface ICollection
    interface IList

[<System.Serializable>]
type Collection = class
    interface ICollection
    interface IList
    interface ISerializable
    interface IDeserializationCallback

Public NotInheritable Class Collection
Implements IList

Public NotInheritable Class Collection
Implements IDeserializationCallback, IList, ISerializable

Ereditarietà

Object

Collection

Attributi

SerializableAttribute

Implementazioni

ICollection IEnumerable IList IDeserializationCallback ISerializable

Esempio

Nell'esempio seguente vengono creati l' Collection oggetto names e una finestra di dialogo con cui un utente può aggiungere oggetti (nomi) alla raccolta.The following example creates the Collection object names and a dialog box with which a user can add objects (names) to the collection. Visualizza quindi i nomi nella raccolta e infine svuota la raccolta senza eliminare l' Collection oggetto stesso.It then displays the names in the collection, and finally empties the collection without disposing of the Collection object itself.

Per verificarne il funzionamento, scegliere il comando Aggiungi classe dal menu progetto e dichiarare una variabile pubblica chiamata instanceName a livello di modulo di nameClass (tipo Public instanceName ) per includere i nomi di ogni istanza.To see how this works, choose the Add Class command from the Project menu and declare a public variable called instanceName at the module level of nameClass (type Public instanceName) to hold the names of each instance. Lasciare il nome predefinito come nameClass .Leave the default name as nameClass. Copiare e incollare il codice seguente nella sezione generale di un altro modulo, quindi avviarlo con l'istruzione classNamer in un'altra procedura.Copy and paste the following code into the General section of another module, and then start it with the statement classNamer in another procedure. Questo esempio funziona solo con le applicazioni host che supportano le classi.(This example works only with host applications that support classes.)

Public Class nameClass
    Public instanceName As String
End Class
Sub classNamer()
    ' Create a Visual Basic Collection object.
    Dim names As New Microsoft.VisualBasic.Collection()
    Dim key As Integer
    Dim msg As String
    Dim name As String
    Dim nameList As String = ""
    ' 1. Get names from the user to add to the collection.
    Do
        Dim inst As New nameClass()
        key += 1
        msg = "Please enter a name for this object." & vbCrLf &
              "Press Cancel to see names in collection."
        name = InputBox(msg, "Name the Collection items")
        inst.instanceName = name
        ' If user entered a name, add it to the collection.
        If inst.instanceName <> "" Then
            names.Add(inst, CStr(key))
        End If
    Loop Until name = ""
    ' 2. Create and display a list of names from the collection.
    For Each oneInst As nameClass In names
        nameList &= oneInst.instanceName & vbCrLf
    Next oneInst
    MsgBox(nameList, , "Instance Names in names Collection")
    ' 3. Remove elements from the collection without disposing of the collection.
    For count As Integer = 1 To names.Count
        names.Remove(1)
        ' Since Visual Basic collections are reindexed automatically, 
        ' remove the first member on each iteration.
    Next count
End Sub

Commenti

L' Collection oggetto Visual Basic fornisce un modo pratico per fare riferimento a un gruppo correlato di elementi come singolo oggetto.The Visual Basic Collection object provides a convenient way to refer to a related group of items as a single object. Gli elementi, o elementi, in una raccolta devono essere correlati solo dal fatto che esistono nella raccolta.The items, or elements, in a collection need only be related by the fact that they exist in the collection. Gli elementi di una raccolta non devono condividere lo stesso tipo di dati.Elements of a collection do not have to share the same data type.

È possibile creare una raccolta nello stesso modo in cui si creano altri oggetti, come illustrato nell'esempio seguente.You can create a collection the same way you create other objects, as the following example illustrates.

Dim coll As New Microsoft.VisualBasic.Collection()  

Dopo aver creato una raccolta, è possibile eseguire una delle operazioni seguenti:Once you have created a collection, you can do any of the following:

• Aggiungere un elemento con il Add metodo.Add an element with the Add method.

• Rimuovere un elemento con il Remove metodo.Remove an element with the Remove method.

• Rimuovere tutti gli elementi con il Clear metodo.Remove all elements with the Clear method.

• Individuare il numero di elementi contenuti nella raccolta con la Count Proprietà.Find out how many elements the collection contains with the Count property.

• Controllare se un elemento specifico è presente con il Contains metodo.Check whether a specific element is present with the Contains method.

• Restituisce un elemento specifico dalla raccolta con la Item[] Proprietà.Return a specific element from the collection with the Item[] property.

• Scorre l'intera raccolta con la per ogni... Istruzione successiva.Iterate through the entire collection with the For Each...Next Statement.

  Nota

  Sebbene l' Collection oggetto Visual Basic disponga di funzionalità identiche all' Collection oggetto in Visual Basic 6,0, le due non possono interagire in un ambiente com.Although the Visual Basic Collection object has functionality identical to the Collection object in Visual Basic 6.0, the two cannot interoperate in a COM environment.

  Attenzione

  L'iterazione di un Visual Basic Collection non è una procedura thread-safe.Iterating through a Visual Basic Collection is not a thread-safe procedure. Anche se la raccolta è sincronizzata, gli altri thread possono comunque modificare la raccolta, causando la generazione di un'eccezione da parte dell'enumeratore.Even if the collection is synchronized, other threads can still modify the collection, causing the enumerator to throw an exception. Per garantire thread safety durante l'enumerazione, bloccare la raccolta o intercettare le eccezioni derivanti dalle modifiche apportate da altri thread.To guarantee thread safety during enumeration, either lock the collection or catch the exceptions resulting from changes made by other threads. Per ulteriori informazioni sul blocco di un elemento di programmazione, vedere istruzione SyncLock.For more information on locking a programming element, see SyncLock Statement.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Metodi di estensione

Si applica a