다음을 통해 공유


XML 자식 축 속성

업데이트: 2007년 11월

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

object.<child>

구성 요소

  • object
    필수 요소입니다. XElement 개체, XDocument 개체, XElement 개체에 대한 컬렉션 또는 XDocument 개체에 대한 컬렉션입니다.

  • .<
    필수 요소입니다. 자식 축 속성의 시작을 나타냅니다.

  • child
    필수 요소입니다. [prefix:]name 형식 중 액세스할 자식 노드의 이름입니다.

    구성 요소

    설명

    prefix

    선택적 요소. 자식 노드의 XML 네임스페이스 접두사입니다. Imports 문을 사용하여 정의된 전역 XML 네임스페이스여야 합니다.

    name

    필수 요소입니다. 로컬 자식 노드 이름입니다. 선언된 XML 요소 및 특성의 이름을 참조하십시오.

  • >
    필수 요소입니다. 자식 축 속성의 끝을 나타냅니다.

반환 값

XElement 개체의 컬렉션입니다.

설명

XML 자식 축 속성을 사용하여 XElement 또는 XDocument 개체의 이름 또는 XElement 또는 XDocument 개체에 대한 컬렉션의 이름으로 자식 노드에 액세스할 수 있습니다. XML Value 속성을 사용하여 반환된 컬렉션의 첫 번째 자식 노드의 값에 액세스할 수 있습니다. 자세한 내용은 XML 값 속성을 참조하십시오.

Visual Basic 컴파일러에서는 자식 축 속성을 Elements 메서드에 대한 호출로 변환합니다.

XML 네임스페이스

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

예제

다음 예제에서는 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>

Dim homePhone = From hp In contact.<phone> _
                Where contact.<phone>.@type = "home" _
                Select hp

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

이 코드가 표시하는 텍스트는 다음과 같습니다.

Home Phone = 206-555-0144

다음 예제에서는 contacts 개체의 contact 자식 축 속성에서 반환된 컬렉션에서 phone이라는 자식 노드에 액세스하는 방법을 보여 줍니다.

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

Dim homePhone = From contact In contacts.<contact> _
                Where contact.<phone>.@type = "home" _
                Select contact.<phone>

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

이 코드가 표시하는 텍스트는 다음과 같습니다.

Home Phone = 206-555-0144

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

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

Class TestClass4

    Shared Sub TestPrefix()
        Dim contact = <ns:contact>
                        <ns:name>Patrick Hines</ns:name>
                      </ns:contact>
        Console.WriteLine(contact.<ns:name>.Value)
    End Sub

End Class

이 코드가 표시하는 텍스트는 다음과 같습니다.

Patrick Hines

참고 항목

개념

선언된 XML 요소 및 특성의 이름

참조

XElement

기타 리소스

XML 축 속성

XML 리터럴

Visual Basic에서 XML 만들기