Partilhar via

Criação de Elementos Constantes Usando sql:is-constant (SQLXML 4.0)

Aplica-se a:SQL ServerBanco de Dados SQL do Azure

Para especificar um elemento constante — ou seja, um elemento no esquema XSD que não corresponde a nenhuma tabela ou coluna de base de dados — pode usar a anotação sql:is-constant . Esta anotação assume um valor booleano (0 = falso, 1 = verdadeiro). Os valores aceitáveis são 0, 1, verdadeiro e falso. A anotação sql:is-constante pode ser especificada num elemento que não tem quaisquer atributos. Se for especificado num elemento com o valor verdadeiro (ou 1), esse elemento não está mapeado para a base de dados, mas continua a aparecer no documento XML.

A anotação sql:is-constante pode ser usada para:

  • Adicionar um elemento de topo ao documento XML. O XML requer um único elemento de topo (elemento raiz) para o documento.

  • Criar elementos de contentor, como um <elemento Orders> que envolve todas as ordens.

A anotação sql:is-constante pode ser adicionada a um <elemento complexType> .

Examples

Para criar exemplos funcionais usando os seguintes exemplos, deve cumprir certos requisitos. Para mais informações, consulte Requisitos para Executar Exemplos de SQLXML.

A. Especificar sql:is-constante para adicionar um elemento de contentor

Neste esquema XSD anotado, <o CustomerOrders> é definido como um elemento constante ao especificar o atributo sql:is-constante com o valor 1. Portanto, <o CustomerOrders> não está mapeado para nenhuma tabela ou coluna da base de dados. Este elemento constante consiste nos elementos filhos <da Ordem> .

Embora <o CustomerOrders> não seja mapeado para nenhuma tabela ou coluna da base de dados, continua a aparecer no XML resultante como um elemento contentor contendo os elementos filhos< da Ordem>.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
<xsd:annotation>  
  <xsd:appinfo>  
    <sql:relationship name="CustOrders"  
        parent="Sales.Customer"  
        parent-key="CustomerID"  
        child="Sales.SalesOrderHeader"  
        child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customer" sql:relation="Sales.Customer" >  
   <xsd:complexType>  
     <xsd:sequence>  
        <xsd:element name="CustomerOrders" sql:is-constant="1" >  
          <xsd:complexType>  
            <xsd:sequence>  
              <xsd:element name="Order" sql:relation="Sales.SalesOrderHeader"  
                           sql:relationship="CustOrders"   
                           maxOccurs="unbounded" >  
                <xsd:complexType>  
                   <xsd:attribute name="SalesOrderID" type="xsd:integer" />  
                   <xsd:attribute name="OrderDate" type="xsd:date" />  
                   <xsd:attribute name="CustomerID" type="xsd:string" />  
                </xsd:complexType>  
              </xsd:element>  
            </xsd:sequence>  
           </xsd:complexType>  
          </xsd:element>  
         </xsd:sequence>  
          <xsd:attribute name="CustomerID" type="xsd:string" />  
     </xsd:complexType>  
  </xsd:element>  
</xsd:schema>
Para testar uma consulta XPath de exemplo contra o esquema

  1. Copie o código do esquema acima e cole num ficheiro de texto. Guarde o ficheiro como isConstant.xml.

  2. Copie o modelo seguinte e cole-o num ficheiro de texto. Guarda o ficheiro como isConstantT.xml no mesmo diretório onde guardaste isConstant.xml.

    <ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">  
    <sql:xpath-query mapping-schema="isConstant.xml">  
        Customer[@CustomerID=1]  
    </sql:xpath-query>  
</ROOT>

    O caminho do diretório especificado para o esquema de mapeamento (isConstant.xml) é relativo ao diretório onde o modelo é guardado. Um caminho absoluto também pode ser especificado, por exemplo:

    mapping-schema="C:\MyDir\isConstant.xml"

  3. Crie e use o Script de Teste SQLXML 4.0 (Sqlxml4test.vbs) para executar o modelo.

    Para mais informações, consulte Utilização de ADO para Executar Consultas SQLXML.

Este é o conjunto parcial de resultados:

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">   
<Customer CustomerID="1">   
  <CustomerOrders>   
    <Order SalesOrderID="43860" OrderDate="2001-08-01" CustomerID="1" />   
    <Order SalesOrderID="44501" OrderDate="2001-11-01" CustomerID="1" />   
    <Order SalesOrderID="45283" OrderDate="2002-02-01" CustomerID="1" />   
    <Order SalesOrderID="46042" OrderDate="2002-05-01" CustomerID="1" />   
    ...  
  </CustomerOrders>   
</Customer>   
</ROOT>
  • Last updated on