Compartilhar via


Operador GetXmlNamespace (Visual Basic)

Obtém o XNamespace objeto que corresponde ao que o prefixo de namespace XML especificado.

GetXmlNamespace(xmlNamespacePrefix)

Partes

  • xmlNamespacePrefix
    Opcional. A seqüência de caracteres que identifica o prefixo de namespace XML. Se for fornecido, essa seqüência de caracteres deve ser um identificador XML válido. Para obter mais informações, consulte Nomes de elementos e atributos XML declarados (Visual Basic). Se nenhum prefixo for especificado, o namespace padrão é retornado. Se nenhum espaço para nome padrão é especificado, o espaço para nome vazio é retornado.

Valor de retorno

O XNamespace objeto que corresponde ao prefixo de namespace XML.

Comentários

O GetXmlNamespace operador obtém o XNamespace objeto que corresponde ao prefixo de namespace XML xmlNamespacePrefix.

Você pode usar os prefixos de namespace XML diretamente no literais XML e propriedades de eixo XML. Entretanto, você deve usar o GetXmlNamespace operador para converter um prefixo de namespace para um XNamespace de objeto antes que você pode usá-lo em seu código. Você pode acrescentar um nome de elemento não qualificado para um XNamespace objeto para obter um totalmente qualificado XName object, que muitos LINQ to XML métodos requerem.

Exemplo

O exemplo a seguir importa ns como um prefixo de namespace XML. Em seguida, usa o prefixo do namespace para criar um XML literal e acessar o primeiro nó filho que possui o nome qualificado ns:phone. Ele passará o nó filho como o ShowName sub-rotina, que constrói um nome qualificado usando o GetXmlNamespace operador. O ShowName sub-rotina, em seguida, passa o nome qualificado para o Ancestors método para obter o pai ns:contact nó.

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

Module GetXmlNamespaceSample

    Sub RunSample()

        ' 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>

        ShowName(contact.<ns:phone>(0))
    End Sub 

    Sub ShowName(ByVal phone As XElement)
        Dim qualifiedName = GetXmlNamespace(ns) + "contact" 
        Dim contact = phone.Ancestors(qualifiedName)(0)
        Console.WriteLine("Name: " & contact.<ns:name>.Value)
    End Sub 

End Module

Quando você chama TestGetXmlNamespace.RunSample(), ele exibe uma caixa de mensagem que contém o seguinte texto:

Name: Patrick Hines

Consulte também

Referência

Instrução Imports (namespace XML)

Outros recursos

Acessando XML no Visual Basic