XML 하위 항목 축 속성
업데이트: 2007년 11월
XElement 개체, XDocument 개체, XElement 개체에 대한 컬렉션 또는 XDocument 개체에 대한 컬렉션의 하위 항목에 대한 액세스를 제공합니다.
object...<descendant>
구성 요소
object
필수적 요소. XElement 개체, XDocument 개체, XElement 개체에 대한 컬렉션 또는 XDocument 개체에 대한 컬렉션으로 구성되어 있습니다....<
필수적 요소. 하위 항목 축 속성의 시작을 나타냅니다.descendant
필수적 요소. [prefix:]name 형식의 액세스할 하위 항목 노드의 이름입니다.구성 요소
설명
prefix
선택적 요소. 하위 항목 노드의 XML 네임스페이스 접두사입니다. Imports 문을 사용하여 정의된 전역 XML 네임스페이스여야 합니다.
name
필수적 요소. 하위 항목 노드의 로컬 이름입니다. 선언된 XML 요소 및 특성의 이름을 참조하십시오.
>
필수적 요소. 하위 항목 축 속성의 끝을 나타냅니다.
반환 값
XElement 개체의 컬렉션입니다.
설명
XML 하위 항목 축 속성을 사용하여 XElement 또는 XDocument 개체의 이름 또는 XElement 또는 XDocument 개체에 대한 컬렉션의 이름으로 하위 항목 노드에 액세스할 수 있습니다. XML Value 속성을 사용하여 반환된 컬렉션의 첫 번째 하위 항목 노드의 값에 액세스할 수 있습니다. 자세한 내용은 XML 값 속성을 참조하십시오.
Visual Basic 컴파일러에서는 하위 항목 축 속성을 Descendants 메서드에 대한 호출로 변환합니다.
XML 네임스페이스
하위 항목 축 속성의 이름은 Imports 문을 사용하여 전역으로 선언된 XML 네임스페이스만 사용할 수 있습니다. XML 요소 리터럴 내에 로컬로 선언된 XML 네임스페이스는 사용할 수 없습니다. 자세한 내용은 Imports 문(XML 네임스페이스)을 참조하십시오.
예제
다음 예제에서는 contacts 개체의 name이라는 첫 번째 하위 항목 노드의 값과 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
다음 예제에서는 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