XNamespace (Clase) (System.Xml.Linq)

La manera más común de crear un objeto XNamespace es simplemente asignarle una cadena. Puede combinar el espacio de nombres con un nombre local utilizando la invalidación del operador de suma. Esta expresión se muestra en el siguiente ejemplo.

XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root", "Content");
Console.WriteLine(root);

Dim aw As XNamespace = "http://www.adventure-works.com"
Dim root As XElement = New XElement(aw + "Root", "Content")
Console.WriteLine(root)

Sin embargo, en Visual Basic, normalmente se declara un espacio de nombres predeterminado global, como se detalla a continuación:

Imports <xmlns='http://www.adventure-works.com'>

Module Module1
    Sub Main()
        Dim root As XElement = _
            <Root>Content</Root>
        Console.WriteLine(root)
    End Sub
End Module

Este ejemplo produce el siguiente resultado.

<Root xmlns="http://www.adventure-works.com">Content</Root>

La asignación de una cadena a un objeto XNamespace, utiliza la conversión implícita de String.

Para obtener más información y ejemplos, vea Cómo crear un documento con espacios de nombres (C#) (LINQ to XML).

Para obtener más información sobre cómo utilizar los espacios de nombres en Visual Basic, vea Espacios de nombres en Visual Basic (LINQ to XML).

Si crea un atributo que declara un espacio de nombres, se conservará en el XML serializado el prefijo especificado en el atributo. Para crear un atributo que declara un espacio de nombres con un prefijo, puede crear un atributo donde el espacio de nombres del nombre del atributo es Xmlns y el nombre del atributo es el prefijo del espacio de nombres. El valor del atributo es el URI del espacio de nombres. Esta expresión se muestra en el siguiente ejemplo.

XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
    new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),
    "Content");
Console.WriteLine(root);

Dim aw As XNamespace = "http://www.adventure-works.com"
Dim root As XElement = New XElement(aw + "Root", _
    New XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"), _
    "Content")
Console.WriteLine(root)

En Visual Basic, en lugar de crear un nodo de espacio de nombres para controlar los prefijos de espacio de nombres, normalmente se utiliza una declaración de espacio de nombres global:

Imports <xmlns:aw='http://www.adventure-works.com'>

Module Module1
    Sub Main()
        Dim root As XElement = _
            <aw:Root>Content</aw:Root>
        Console.WriteLine(root)
    End Sub
End Module

Este ejemplo produce el siguiente resultado.

<aw:Root xmlns:aw="http://www.adventure-works.com">Content</aw:Root>

Para obtener más información, vea Cómo controlar prefijos de espacios de nombres (C#) (LINQ to XML).

Al construir un atributo que va a ser un espacio de nombres, si el nombre de atributo tiene el valor especial de "xmlns", cuando se serializa el árbol XML, el espacio de nombres se declara como el espacio de nombres predeterminado. El atributo especial con el nombre de "xmlns" en sí no es ningún espacio de nombres. El valor del atributo es el URI del espacio de nombres.

En el ejemplo siguiente se crea un árbol XML que contiene un atributo que se declara de tal manera que el espacio de nombres se convertirá en el espacio de nombres predeterminado:

XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
    new XAttribute("xmlns", "http://www.adventure-works.com"),
    new XElement(aw + "Child", "content")
);
Console.WriteLine(root);

Dim aw As XNamespace = "http://www.adventure-works.com"
Dim root As XElement = New XElement(aw + "Root", _
    New XAttribute("xmlns", "http://www.adventure-works.com"), _
    New XElement(aw + "Child", "content") _
)
Console.WriteLine(root)

En Visual Basic, en lugar de crear un nodo de espacio de nombres para crear un espacio de nombres predeterminado, normalmente se utiliza una declaración de espacio de nombres predeterminada global:

Imports <xmlns='http://www.adventure-works.com'>

Module Module1
    Sub Main()
        Dim root As XElement = _
            <Root>
                <Child>content</Child>
            </Root>
        Console.WriteLine(root)
    End Sub
End Module

Este ejemplo produce el siguiente resultado.

<Root xmlns="http://www.adventure-works.com">
  <Child>content</Child>
</Root>

Se garantiza que los objetos XNamespace se subdividen; es decir, si dos objetos XNamespace tienen exactamente el mismo URI, compartirán la misma instancia. Los operadores de comparación e igualdad se proporcionan explícitamente para este propósito.

Otra manera de especificar un espacio de nombres y un nombre local es utilizar un nombre expandido en la forma de {namespace}name:

[C#]

XElement e = new XElement("{http://www.adventure-works.com}Root",
     new XAttribute("{http://www.adventure-works.com}Att", "content")
);
Console.WriteLine(e);

Dim e As XElement = New XElement("{http://www.adventure-works.com}Root", _
     New XAttribute("{http://www.adventure-works.com}Att", "content") _
)
Console.WriteLine(e)

Este ejemplo produce el siguiente resultado.

<Root p1:Att="content" xmlns:p1="http://www.adventure-works.com" xmlns="http://www.adventure-works.com" />

Este enfoque tiene implicaciones de rendimiento. Cada vez que pasa una cadena que contiene un nombre expandido a LINQ to XML, debe analizar el nombre, buscar el espacio de nombres subdividido y buscar el nombre subdividido. Este proceso consume tiempo de la CPU. Si es importante el rendimiento, quizá prefiera utilizar otro enfoque.

Con Visual Basic, el enfoque recomendado es utilizar los literales de XML, que no implican el uso de nombres expandidos.