Remove 메서드(Collection 개체)
업데이트: 2007년 11월
Collection 개체에서 요소를 제거합니다.
Public Overloads Sub Remove(_
ByVal { Key As String | Index As Integer } _
)
매개 변수
Key
위치 인덱스 대신 컬렉션의 요소에 액세스하는 데 사용할 수 있는 키 문자열을 지정하는 고유 String 식입니다. Key는 요소를 컬렉션에 추가할 때 지정된 Key 인수와 일치해야 합니다.Index
컬렉션 요소의 위치를 지정하는 숫자 식입니다. Index는 1부터 컬렉션의 Count 속성(Collection 개체) 값 사이의 숫자여야 합니다.
예외
예외 형식 |
오류 번호 |
조건 |
|---|---|---|
Key가 잘못되었거나 지정되지 않았습니다. |
||
Index가 컬렉션의 기존 요소와 일치하지 않습니다. |
비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.
설명
Remove는 컬렉션에서 요소를 삭제할 때 컬렉션의 Count 속성(Collection 개체) 값을 1씩 줄입니다. 또한 컬렉션에서 삭제된 요소 다음에 있었던 모든 요소의 Index 값을 줄입니다.
Key를 사용하지 않고 요소를 컬렉션에 추가한 경우 해당 요소를 제거하려면 Index를 사용해야 합니다.
예제
다음 예제에서는 Remove 메서드를 사용하여 birthdays 변수의 Collection 개체(Visual Basic)에서 개체를 제거하는 방법을 보여 줍니다.
Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")
...
birthdays.Remove(1)
birthdays.Remove("Mike")
Add 메서드를 네 번 호출하면 Count 속성에 4가 포함되고 "Bill" 요소의 인덱스 값은 1이 되고 "Pete" 요소의 인덱스 값은 4가 됩니다.
Remove를 처음 호출하면 Count가 3이 되고, "Bill" 요소가 삭제되고, "Pete" 요소의 인덱스 값이 3이 됩니다.
Remove를 두 번째 호출하면 Count가 2가 되고, "Mike" 요소가 삭제되고, "Pete" 요소의 인덱스 값이 2가 됩니다.
요구 사항
네임스페이스:Microsoft.VisualBasic
**모듈:**Collection
**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)