WITH XMLNAMESPACES (Transact-SQL)

Artigo
06/18/2013

Declara um ou mais namespaces XML.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

WITH XMLNAMESPACES ( <XML namespace declaration item>
[ { , <XML namespace declaration item> }...] )  

<XML namespace declaration item> ::=
<xml_namespace_uri> AS <xml_namespace_prefix>
| <XML default namespace declaration item>
<xml_namespace_uri> ::= <character string literal>

<xml_namespace_prefix> ::= <identifier>

<XML default namespace declaration item> ::= 
DEFAULT <xml_namespace_uri>

Argumentos

xml_namespace_uri
Um URI que identifica o namespace XML que está sendo declarado. xml_namespace_uri é uma cadeia de caracteres SQL.
xml_namespace_prefix
Especifica um prefixo a ser mapeado e associado ao valor URI do namespace especificado em xml_namespace_uri. xml_namespace_prefix deve ser um identificador do SQL Server.

Comentários

Quando você usa a cláusula WITH XMLNAMESPACES em uma instrução que também inclui uma expressão de tabela comum, a cláusula WITH XMLNAMESPACES deve preceder a expressão na instrução.

Os seguintes itens são regras gerais de sintaxe que se aplicam quando você usa a cláusula WITH XMLNAMESPACES:

Cada declaração de namespace XML deve conter pelo menos um item de declaração de namespace padrão XML.
Cada prefixo de namespace XML usado deve ser um NCName (non-colonized name) no qual o dois-pontos (:) não faz parte do nome.
Você não pode definir um prefixo de namespace duas vezes.
Prefixos de namespace XML e URIs diferenciam maiúsculas de minúsculas.
O prefixo de namespace XML xmlns não pode ser declarado.
O prefixo de namespace XML xml não pode ser substituído por um namespace diferente do URI de namespaces 'http://www.w3.org/XML/1998/namespace', e este URI não pode receber um prefixo diferente.
O prefixo de namespace XML xsi não pode ser redeclarado quando a diretiva ELEMENTS XSINIL está sendo usada na consulta.
Os valores de cadeia de caracteres URI são codificados de acordo com a página de código de agrupamento de banco de dados atual e são convertidos internamente em Unicode.
O URI de namespace XML terá o espaço em branco reduzido segundo as regras de redução de espaço em branco XSD usadas para xs:anyURI. Além disso, observe que são executados definições de entidade ou cancelamentos de definição em valores URI de namespaces XML.
Será verificado no URI de namespace XML se há caracteres XML 1.0 que não sejam válidos, e será gerado um erro se algum for encontrado (por exemplo, U+0007).
O URI de namespace XML (após todo o espaço em branco ser reduzido) não pode ser uma cadeia de caracteres de comprimento ou ocorrerá um erro relacionado a URI de namespace vazio inválido.
A palavra-chave XMLNAMESPACES é reservada no contexto da cláusula WITH.

Exemplos

Para obter exemplos, consulte Adicionar namespaces a consultas com WITH XMLNAMESPACES.

Consulte também

Outros recursos

Referência de linguagem Xquery (SQL Server)

Partilhar via