Collection.Add(Object, String, Object, Object) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un elemento all'oggetto Collection
.
public void Add (object? Item, string? Key = default, object? Before = default, object? After = default);
public void Add (object Item, string Key = default, object Before = default, object After = default);
member this.Add : obj * string * obj * obj -> unit
Public Sub Add (Item As Object, Optional Key As String = Nothing, Optional Before As Object = Nothing, Optional After As Object = Nothing)
Parametri
- Item
- Object
Obbligatorio. Oggetto di qualsiasi tipo che specifica l'elemento da aggiungere alla raccolta.
- Key
- String
facoltativo. Espressione String
univoca che specifica una stringa chiave utilizzabile al posto di un indice di posizione per accedere a questo nuovo elemento della raccolta.
- Before
- Object
facoltativo. Espressione che specifica una posizione relativa nella raccolta. L'elemento da aggiungere viene inserito nella raccolta prima dell'elemento identificato dall'argomento Before
. Se Before
è un'espressione numerica, deve essere un numero compreso tra 1 e il valore della proprietà Count della raccolta. Se Before
è un'espressione String
, deve corrispondere alla stringa della chiave specificata quando l'elemento a cui viene fatto riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before
che After
.
- After
- Object
facoltativo. Espressione che specifica una posizione relativa nella raccolta. L'elemento da aggiungere viene inserito nella raccolta dopo l'elemento identificato dall'argomento After
. Se After
è un'espressione numerica, deve essere un numero compreso tra 1 e il valore della proprietà Count
della raccolta. Se After
è un'espressione String
, deve corrispondere alla stringa della chiave specificata quando l'elemento a cui viene fatto riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before
che After
.
Esempio
Nell'esempio seguente viene usato il Add
metodo per aggiungere child
oggetti - istanze di una classe denominata contenente una Public
proprietà name
- a una raccolta denominata child
family
. Per vedere come funziona, creare un oggetto Form con due Button controlli e impostare le relative Text proprietà su Add
e List
. Aggiungere la definizione della classe e la child
family
dichiarazione al codice del modulo. Modificare i gestori eventi per i _Click
pulsanti Aggiungi e Elenco , come illustrato. Il pulsante Aggiungi consente di aggiungere elementi figlio. Il pulsante Elenco visualizza i nomi di tutti gli elementi figlio.
Public Class child
Public name As String
Sub New(ByVal newName As String)
name = newName
End Sub
End Class
' Create a Collection object.
Private family As New Collection()
Private Sub addChild_Click() Handles Button1.Click
Dim newName As String
newName = InputBox("Name of new family member: ")
If newName <> "" Then
family.Add(New child(newName), newName)
End If
End Sub
Private Sub listChild_Click() Handles Button2.Click
For Each aChild As child In family
MsgBox(aChild.name)
Next
End Sub
Commenti
L'argomento Before
o After
deve fare riferimento a un elemento esistente della raccolta. In caso contrario, si verifica un errore.
Se entrambi gli Before
argomenti e After
vengono omessi, il nuovo oggetto viene aggiunto alla fine dell'insieme.
Si verifica anche un errore se un valore specificato Key
corrisponde alla chiave per un elemento esistente della raccolta.
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per