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

정의

네임스페이스:
Microsoft.VisualBasic
어셈블리:
Microsoft.VisualBasic.dll

개체에 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

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

Before
Object

Optional. 컬렉션의 상대 위치를 지정하는 식입니다. 추가할 요소가 인수로 식별된 요소 앞에 컬렉션에 Before 배치됩니다. 숫자 식인 경우 Before 1부터 컬렉션 Count 속성 값까지의 숫자여야 합니다. 식인 String 경우 Before 참조되는 요소가 컬렉션에 추가될 때 지정된 키 문자열에 해당해야 합니다. 둘 다 Before 지정할 수 없습니다.After

After
Object

Optional. 컬렉션의 상대 위치를 지정하는 식입니다. 추가할 요소는 인수로 식별된 요소 뒤의 컬렉션에 After 배치됩니다. 숫자 식인 경우 After 1부터 컬렉션 Count 속성 값까지의 숫자여야 합니다. 식인 String 경우 After 참조된 요소가 컬렉션에 추가되었을 때 지정된 키 문자열에 해당해야 합니다. 둘 다 Before 지정할 수 없습니다.After

예제

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

적용 대상