XML 하위 항목 축 속성(Visual Basic)

XElement 개체, XDocument 개체, XElement 개체 컬렉션 또는 XDocument 개체 컬렉션의 하위 항목에 대한 액세스를 제공합니다.

구문

object...<descendant>

부분

object 필수입니다. XElement 개체, XDocument 개체, XElement 개체의 컬렉션 또는 XDocument 개체의 컬렉션입니다.

...< 필수입니다. 하위 축 속성의 시작을 나타냅니다.

descendant 필수입니다. 액세스할 하위 노드의 이름으로, [prefix:]name 형식입니다.

> 필수입니다. 하위 축 속성의 끝을 나타냅니다.

Return Value

XElement 개체의 컬렉션입니다.

설명

XML 하위 축 속성을 사용하면 XElement 또는 XDocument 개체나 XElement 또는 XDocument 개체 컬렉션에서 이름으로 하위 노드에 액세스할 수 있습니다. 반환된 컬렉션의 첫 번째 하위 노드 값에 액세스하려면 XML Value 속성을 사용합니다. 자세한 내용은 XML 값 속성을 참조하세요.

Visual Basic 컴파일러는 하위 축 속성을 Descendants 메서드 호출로 변환합니다.

XML 네임스페이스

하위 축 속성의 이름은 Imports 문을 사용하여 전역적으로 선언된 XML 네임스페이스만 사용할 수 있습니다. XML 요소 리터럴 내에서 로컬로 선언된 XML 네임스페이스를 사용할 수 없습니다. 자세한 내용은 Imports 문(XML 네임스페이스)을 참조하세요.

예 1

다음 예에서는 name이라는 첫 번째 하위 노드의 값과 contacts 개체에서 phone이라는 모든 하위 노드의 값에 액세스하는 방법을 보여 줍니다.

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

Console.WriteLine("Name: " & contacts...<name>.Value)

Dim homePhone = From phone In contacts...<phone> 
                Select phone.Value

Console.WriteLine("Home Phone = {0}", homePhone(0))

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

Name: Patrick Hines

Home Phone = 206-555-0144

예제 2

다음 예제에서는 ns를 XML 네임스페이스 접두사로 선언한 다음 네임스페이스의 접두사를 사용하여 XML 리터럴을 만들고 정규화된 이름 ns:name을 가진 첫 번째 자식 노드의 값에 액세스합니다.

Imports <xmlns:ns = "http://SomeNamespace"> 
 
Class TestClass2

    Shared Sub TestPrefix()
        Dim contacts = 
            <ns:contacts>
                <ns:contact>
                    <ns:name>Patrick Hines</ns:name>
                </ns:contact>
            </ns:contacts>

        Console.WriteLine("Name: " & contacts...<ns:name>.Value)
    End Sub

End Class

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

Name: Patrick Hines

참고 항목

• XElement
• XML 축 속성
• XML 리터럴
• Visual Basic에서 XML 만들기
• 선언된 XML 요소 및 특성의 이름