Collection.Add(Object, String, Object, Object) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Adiciona um elemento a um Collection objeto.

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)

Parâmetros

Item
Object

Required. Um objeto de qualquer tipo que especifique o elemento a adicionar à coleção.

Key
String

Optional. Uma expressão única String que especifica uma cadeia de chaves que pode ser usada em vez de um índice posicional para aceder a este novo elemento na coleção.

Before
Object

Optional. Uma expressão que especifica uma posição relativa na coleção. O elemento a ser adicionado é colocado na coleção antes do elemento identificado pelo Before argumento. Se Before for uma expressão numérica, deve ser um número de 1 até ao valor da propriedade da Count coleção. Se Before for uma String expressão, deve corresponder à cadeia de chaves especificada quando o elemento referido foi adicionado à coleção. Não pode especificar tanto Before como After.

After
Object

Optional. Uma expressão que especifica uma posição relativa na coleção. O elemento a ser adicionado é colocado na coleção após o elemento identificado pelo After argumento. Se After for uma expressão numérica, deve ser um número de 1 até ao valor da propriedade da Count coleção. Se After for uma String expressão, deve corresponder à cadeia de chaves especificada quando o elemento referido foi adicionado à coleção. Não pode especificar tanto Before como After.

Exemplos

O exemplo seguinte utiliza o Add método para adicionar child objetos – instâncias de uma classe chamada child contendo uma Public propriedade name – a uma coleção chamada family. Para ver como isto funciona, crie um Form com dois Button controlos e defina as suas Text propriedades para Add e List. Adicione a definição da child classe e a family declaração ao código do formulário. Modificar os _Click handlers de eventos para os botões Adicionar e Listar conforme mostrado. O botão Adicionar permite adicionar filhos. O botão Lista mostra os nomes de todas as crianças.

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

Observações

O Before argumento ou After deve referir-se a um elemento existente da coleção; caso contrário, ocorre um erro.

Se ambos os Before argumentos e After forem omitidos, o novo objeto é adicionado ao final da coleção.

Um erro também ocorre se um valor especificado Key coincidir com a chave de um elemento existente da coleção.

Aplica-se a