Collection.Add(Object, String, Object, Object) 메서드

정의

네임스페이스:

Microsoft.VisualBasic

어셈블리:

Microsoft.VisualBasic.Core.dll

Source:

Collection.vb

Collection 개체에 요소를 추가합니다.

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)

매개 변수

Item

Object

필수 요소. 컬렉션에 추가할 요소를 지정하는 임의의 유형의 개체입니다.

Key

String

선택 사항입니다. 위치 인덱스 대신 컬렉션의 이 새 요소에 액세스하는 데 사용할 수 있는 키 문자열을 지정하는 고유 String 식입니다.

Before

Object

선택 사항입니다. 컬렉션에서 상대적 위치를 지정하는 식입니다. 컬렉션에서 추가되는 요소는 Before 인수에 의해 식별되는 요소 앞에 옵니다. Before가 숫자 식인 경우 이 인수는 1에서 컬렉션의 Count 속성 값 사이의 숫자여야 합니다. Before가 String 식인 경우 이 인수는 참조되는 요소가 컬렉션에 추가될 때 지정한 키 문자열과 일치해야 합니다. Before와 After를 둘 다 지정할 수는 없습니다.

After

Object

선택 사항입니다. 컬렉션에서 상대적 위치를 지정하는 식입니다. 컬렉션에서 추가되는 요소는 After 인수에 의해 식별되는 요소 뒤에 옵니다. After가 숫자 식인 경우 이 인수는 1에서 컬렉션의 Count 속성 값 사이의 숫자여야 합니다. After가 String 식인 경우 이 인수는 참조되는 요소가 컬렉션에 추가될 때 지정한 키 문자열과 일치해야 합니다. Before와 After를 둘 다 지정할 수는 없습니다.

예제

다음 예제에서는 메서드를 Add 사용하여 속성을 name 포함하는 클래스 child 의 인스턴스인 개체를 Public 라는 family컬렉션에 추가 child 합니다. 이 작동 방식을 확인하려면 두 개의 Button 컨트롤을 사용하여 을 Form 만들고 해당 Text 속성을 및 List로 Add 설정합니다. child 클래스 정의 및 선언을 family 양식 코드에 추가합니다. _Click 표시된 것처럼 추가 및 목록 단추에 대한 이벤트 처리기를 수정합니다. 추가 단추를 사용하면 자식을 추가할 수 있습니다. 목록 단추는 모든 자식의 이름을 표시합니다.

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

설명

또는 After 인수는 Before 컬렉션의 기존 요소를 참조해야 합니다. 그렇지 않으면 오류가 발생합니다.

및 After 인수를 Before 모두 생략하면 새 개체가 컬렉션의 끝에 추가됩니다.

지정된 Key 값이 컬렉션의 기존 요소에 대한 키와 일치하는 경우에도 오류가 발생합니다.