Collection Sınıf

Tanım

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

Devralma

Object

Collection

Öznitelikler

SerializableAttribute

Uygulamalar

ICollection IEnumerable IList IDeserializationCallback ISerializable

Örnekler

Aşağıdaki örnek, Collection names bir kullanıcının koleksiyona nesneler (adlar) ekleyebileceği nesne ve iletişim kutusu oluşturur.The following example creates the Collection object names and a dialog box with which a user can add objects (names) to the collection. Daha sonra koleksiyonda adları görüntüler ve son olarak nesnenin kendisini elden çıkmadan koleksiyonu boşaltır Collection .It then displays the names in the collection, and finally empties the collection without disposing of the Collection object itself.

Bunun nasıl çalıştığını görmek için, Proje menüsünden Sınıf Ekle komutunu seçin ve instanceName nameClass her bir Public instanceName Örneğin adlarını tutmak için modül düzeyinde (tür) adlı bir genel değişken bildirin.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. Varsayılan adı olarak bırakın nameClass .Leave the default name as nameClass. Aşağıdaki kodu kopyalayıp başka bir modülün genel bölümüne yapıştırın ve sonra classNamer başka bir yordamdaki ifadesiyle başlatın.Copy and paste the following code into the General section of another module, and then start it with the statement classNamer in another procedure. (Bu örnek yalnızca sınıfları destekleyen ana bilgisayar uygulamalarıyla birlikte kullanılabilir.)(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

Açıklamalar

Visual Basic Collection nesnesi, ilgili öğe grubuna tek bir nesne olarak başvurmak için kullanışlı bir yol sağlar.The Visual Basic Collection object provides a convenient way to refer to a related group of items as a single object. Bir koleksiyondaki öğelerin veya öğelerin yalnızca koleksiyonda bulundukları olgu ile ilişkili olması gerekir.The items, or elements, in a collection need only be related by the fact that they exist in the collection. Bir koleksiyonun öğelerinin aynı veri türünü paylaşması gerekmez.Elements of a collection do not have to share the same data type.

Aşağıdaki örnekte gösterildiği gibi, başka nesneler oluşturduğunuz gibi bir koleksiyon oluşturabilirsiniz.You can create a collection the same way you create other objects, as the following example illustrates.

Dim coll As New Microsoft.VisualBasic.Collection()  

Bir koleksiyon oluşturduktan sonra aşağıdakilerden birini yapabilirsiniz:Once you have created a collection, you can do any of the following:

• Yöntemiyle bir öğesi ekleyin Add .Add an element with the Add method.

• Yöntemi ile bir öğesi kaldırın Remove .Remove an element with the Remove method.

• Tüm öğeleri Clear yöntemiyle kaldırın.Remove all elements with the Clear method.

• Özelliği ile koleksiyonun kaç öğe içerdiğini öğrenin Count .Find out how many elements the collection contains with the Count property.

• Yöntemiyle belirli bir öğenin mevcut olup olmadığını denetleyin Contains .Check whether a specific element is present with the Contains method.

• Özelliği ile koleksiyondan belirli bir öğe döndürün Item[] .Return a specific element from the collection with the Item[] property.

• Her for each ile koleksiyonun tamamında yineleyin ... Sonraki Ifade.Iterate through the entire collection with the For Each...Next Statement.

  Not

  Visual Basic nesnesi, Collection Visual Basic 6,0 ' deki nesneyle özdeş işlevlere sahip olsa da Collection , IKISI bir com ortamında birlikte çalışamaz.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.

  Dikkat

  Visual Basic arasında yineleme Collection , iş parçacığı güvenli bir yordam değildir.Iterating through a Visual Basic Collection is not a thread-safe procedure. Koleksiyon eşitlense de, diğer iş parçacıkları koleksiyonu değiştirebilir ve Numaralandırıcının bir özel durum oluşturmasını sağlar.Even if the collection is synchronized, other threads can still modify the collection, causing the enumerator to throw an exception. Numaralandırma sırasında iş parçacığı güvenliğini güvence altına almak için, koleksiyonu kilitleyin ya da diğer iş parçacıkları tarafından yapılan değişikliklerden kaynaklanan özel durumları yakalayın.To guarantee thread safety during enumeration, either lock the collection or catch the exceptions resulting from changes made by other threads. Bir programlama öğesini kilitleme hakkında daha fazla bilgi için bkz. SyncLock deyimleri.For more information on locking a programming element, see SyncLock Statement.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır