다음을 통해 공유


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

정의

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)

매개 변수

Item
Object

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

Key
String

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

Before
Object

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

After
Object

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

예제

다음 예제에서는 메서드를 Add 사용하여 속성을 name 포함하는 클래스 child 의 인스턴스인 개체를 Public 라는 family컬렉션에 추가 child 합니다. 이 작동 방식을 확인하려면 두 개의 Button 컨트롤을 사용하여 을 Form 만들고 해당 Text 속성을 및 ListAdd 설정합니다. 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 값이 컬렉션의 기존 요소에 대한 키와 일치하는 경우에도 오류가 발생합니다.

적용 대상