다음을 통해 공유

확장 인덱서 속성(Visual Basic)

  • 아티클

컬렉션의 개별 요소에 액세스할 수 있도록 합니다.

구문

object(index)

부분

용어 정의
object 필수입니다. 쿼리 가능한 컬렉션. 즉, IEnumerable<T> 또는 IQueryable<T>를 구현하는 컬렉션입니다.
( 필수입니다. 인덱서 속성의 시작을 나타냅니다.
index 필수입니다. 컬렉션 요소의 0부터 시작 위치를 지정하는 정수 식입니다.
) 필수입니다. 인덱서 속성의 끝을 나타냅니다.

Return Value

컬렉션의 지정된 위치에 있는 개체이거나, 인덱스가 범위를 벗어난 경우에는 Nothing입니다.

설명

확장 인덱서 속성을 사용하여 컬렉션의 개별 요소에 액세스할 수 있습니다. 이 인덱서 속성은 일반적으로 XML 축 속성의 출력에 사용됩니다. XML 자식 및 XML 자식 축 속성은 XElement 개체 컬렉션 또는 특성 값을 반환합니다.

Visual Basic 컴파일러는 확장 인덱서 속성을 ElementAtOrDefault 메서드 호출로 변환합니다. 배열 인덱서와 달리 ElementAtOrDefault 메서드는 인덱스가 범위를 벗어나면 Nothing을 반환합니다. 이 동작은 컬렉션의 요소 수를 쉽게 확인할 수 없을 때 유용합니다.

이 인덱서 속성은 IEnumerable<T> 또는 IQueryable<T>를 구현하는 컬렉션의 확장 속성과 같습니다. 컬렉션에 인덱서 또는 기본 속성이 없는 경우에만 사용됩니다.

XElement 또는 XAttribute 개체 컬렉션의 첫 번째 요소 값에 액세스하려면 XML Value 속성을 사용할 수 있습니다. 자세한 내용은 XML 값 속성을 참조하세요.

예시

다음 예에서는 확장 인덱서를 사용하여 XElement 개체 컬렉션의 두 번째 자식 노드에 액세스하는 방법을 보여 줍니다. 컬렉션은 contact 개체에서 phone이라는 모든 자식 요소를 가져오는 자식 축 속성을 사용하여 액세스됩니다.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Console.WriteLine("Second phone number: " & contact.<phone>(1).Value)

이 코드의 텍스트는 다음과 같습니다.

Second phone number: 425-555-0145

참고 항목