Compartir a través de


Información general sobre LINQ to XML en Visual Basic

Visual Basic proporciona compatibilidad con LINQ to XML a través de literales XML y propiedades de eje XML. Esto le permite usar una sintaxis conocida y apropiada para trabajar con XML en el código de Visual Basic. Los literales XML permiten incluir XML directamente en el código. Las propiedades de eje XML permiten tener acceso a los nodos secundarios, los nodos descendientes y los atributos de un literal XML. Para obtener más información, vea Información general sobre literales XML (Visual Basic) y Obtener acceso a XML en Visual Basic.

LINQ to XML es una API de programación XML en memoria diseñada específicamente para aprovechar la funcionalidad de Language-Integrated Query (LINQ). Aunque puede llamar a las API de LINQ directamente, solo Visual Basic  permite declarar literales XML y tener acceso directo a las propiedades de eje XML.

Nota

Los literales XML y las propiedades de eje XML no se admiten en el código declarativo de una página ASP.NET. Para utilizar las características de XML de Visual Basic, coloque el código en una página de código subyacente en la aplicación ASP.NET.

vínculo a vídeo Dispone de demostraciones relacionadas en vídeo en How Do I Get Started with LINQ to XML? y How D o I Create Excel Spreadsheets using LINQ to LINQ?.

Crear XML

Hay dos maneras de crear árboles XML en Visual Basic. Puede declarar un literal XML directamente en código o puede utilizar la API de LINQ. Ambos procesos permiten que el código refleje la estructura final del árbol XML. Por ejemplo, el siguiente ejemplo de código crea un elemento XML:

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

Para obtener más información, vea Crear XML en Visual Basic.

Visual Basic proporciona propiedades de eje XML para obtener acceso y navegar por las estructuras XML. Estas propiedades permiten tener acceso a los elementos y atributos XML especificando los nombres de los elementos secundarios XML. O bien, puede llamar explícitamente a los métodos de LINQ para navegar y buscar elementos y atributos. Por ejemplo, el ejemplo de código siguiente utiliza propiedades de eje XML para hacer referencia a los atributos y elementos secundarios de un elemento XML. El ejemplo de código usa una consulta LINQ para recuperar los elementos secundarios y generarlos como elementos XML, realizando eficazmente una transformación.

' Place Imports statements at the top of your program.  
Imports <xmlns:ns="http://SomeNamespace">

Module Sample1

    Sub SampleTransform()

        ' Create test by using a global XML namespace prefix. 

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

        Dim phoneTypes = 
          <phoneTypes>
              <%= From phone In contact.<ns:phone> 
                  Select <type><%= phone.@ns:type %></type> 
              %>
          </phoneTypes>

        Console.WriteLine(phoneTypes)
    End Sub

End Module

Para obtener más información, vea Obtener acceso a XML en Visual Basic.

Espacios de nombres XML

Visual Basic permite especificar un alias en un espacio de nombres XML global utilizando la instrucción Imports. El ejemplo siguiente muestra cómo utilizar la instrucción Imports para importar un espacio de nombres XML:

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

Puede utilizar un alias de espacio de nombres XML al obtener acceso a las propiedades de eje XML y declarar literales XML para los documentos y elementos XML.

Puede recuperar un objeto XNamespace de un prefijo de espacio de nombres concreto mediante GetXmlNamespace (Operador) (Visual Basic).

Para obtener más información, vea Imports (Instrucción, Espacio de nombres XML).

Utilizar espacios de nombres XML en literales XML

El ejemplo siguiente muestra cómo crear un objeto XElement que utiliza el espacio de nombres nsglobal:

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

Console.WriteLine(contact1)

El compilador de Visual Basic traduce literales XML que contienen los alias del espacio de nombres XML en código equivalente que utiliza la notación XML para usar los espacios de nombres XML, con el atributo xmlns. Cuando se compila, el código del ejemplo de la sección anterior genera básicamente el mismo código ejecutable que el ejemplo siguiente:

Dim contact2 As XElement = 
    <ns1:contact xmlns:ns1="http://someNamespace">
        <ns1:name>Patrick Hines</ns1:name>
        <ns1:phone type="home">206-555-0144</ns1:phone>
        <ns1:phone type="work">425-555-0145</ns1:phone>
    </ns1:contact>

Console.WriteLine(contact2)

Usar los espacios de nombres XML en propiedades de eje XML

Los espacios de nombres XML declarados en literales XML no están disponibles para su uso en propiedades de eje XML. Sin embargo, los espacios de nombres globales se pueden utilizar con las propiedades de eje XML. Use dos puntos para separar el prefijo del espacio de nombres XML del nombre del elemento local. A continuación, se muestra un ejemplo:

Console.WriteLine("Contact name is: " & contact1.<ns:name>.Value)

Vea también

Otros recursos

XML en Visual Basic

Crear XML en Visual Basic

Obtener acceso a XML en Visual Basic

Manipular XML en Visual Basic