Compartir a través de

Propiedad Eje secundario XML (Visual Basic)

Proporciona acceso a los hijos de uno de los siguientes elementos: un XElement objeto, un XDocument objeto, una colección de XElement objetos o una colección de XDocument objetos.

Sintaxis

object.<child>

Partes

Término Definición
object Obligatorio. Un XElement objeto, un XDocument objeto, una colección de XElement objetos o una colección de XDocument objetos .
.< Obligatorio. Indica el inicio de una propiedad de eje secundario.
child Obligatorio. Nombre de los nodos secundarios a los que se va a acceder, con el formato [prefix:]name.

- Prefix -Opcional. Prefijo de espacio de nombres XML para el nodo secundario. Debe ser un espacio de nombres XML global definido con una Imports instrucción .
- Name -Obligatorio. Nombre del nodo secundario local. Vea Nombres de atributos y elementos XML declarados.
> Obligatorio. Indica el final de una propiedad de eje secundario.

Valor devuelto

Una colección de objetos XElement.

Observaciones

Puede usar una propiedad de eje secundario XML para tener acceso a los nodos secundarios por su nombre desde un XElement objeto o XDocument desde una colección de XElement objetos o XDocument . Utilice la propiedad XML Value para tener acceso al valor del primer nodo secundario de la colección devuelta. Para obtener más información, vea Xml Value Property.

El compilador de Visual Basic convierte las propiedades del eje secundario en llamadas al Elements método .

Espacios de nombres XML

El nombre de una propiedad del eje secundario solo puede usar prefijos de espacio de nombres XML declarados globalmente con la Imports instrucción . No puede usar prefijos de espacio de nombres XML declarados localmente en literales de elemento XML. Para más información, consulte Imports (Instrucción, Espacio de nombres XML).

Ejemplo 1

En el ejemplo siguiente se muestra cómo acceder a los nodos secundarios denominados phone desde el contact objeto .

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)

Este código muestra el texto siguiente:

Home Phone = 206-555-0144

Ejemplo 2

En el ejemplo siguiente se muestra cómo obtener acceso a los nodos secundarios denominados phone desde la colección devuelta por la contact propiedad del eje secundario del contacts objeto .

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)

Este código muestra el texto siguiente:

Home Phone = 206-555-0144

Ejemplo 3

En el ejemplo siguiente se declara ns como prefijo de espacio de nombres XML. A continuación, usa el prefijo del espacio de nombres para crear un literal XML y acceder al primer nodo secundario con el nombre ns:namecompleto .

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

Este código muestra el texto siguiente:

Patrick Hines

Consulte también

  • Last updated on