Usando o Carregamento em Massa de SQLXML no ambiente .NET

Este tópico explica como a funcionalidade de Carregamento em Massa de XML pode ser usada no ambiente .NET. Para obter informações detalhadas sobre o Carregamento em Massa de XML, consulte Executando o carregamento em massa de dados XML (SQLXML 4.0).

Para usar o objeto COM do Carregamento em Massa de SQLXML de um ambiente gerenciado, você precisa adicionar uma referência de projeto a esse objeto. Isso gera uma interface de wrapper gerenciado em torno do objeto COM do Carregamento em Massa.

Observação

O Carregamento em Massa de XML gerenciado não funciona com fluxos gerenciados e exige um wrapper em torno dos fluxos nativos. O componente de Carregamento em Massa de SQLXML não será executado em um ambiente multithread (atributo '[MTAThread]'). Se você tentar executar o componente de Carregamento em Massa em um ambiente multithread, obterá uma exceção InvalidCastException com as informações adicionais de que houve falha do QueryInterface para interface SQLXMLBULKLOADLib.ISQLXMLBulkLoad. A solução alternativa consiste em tornar acessível o objeto que contém um thread único do objeto de Carregamento em Massa (por exemplo, usando o atributo [STAThread] conforme mostrado no exemplo).

Este tópico fornece um exemplo de aplicativo C# funcional para carregamento em massa de dados XML no banco de dados. Para criar um exemplo funcional, siga estas etapas:

1. Crie as tabelas a seguir:

   CREATE TABLE Ord (
            OrderID     int identity(1,1)  PRIMARY KEY,
            CustomerID  varchar(5))
   GO
   CREATE TABLE Product (
            ProductID   int identity(1,1) PRIMARY KEY,
            ProductName varchar(20))
   GO
   CREATE TABLE OrderDetail (
          OrderID     int FOREIGN KEY REFERENCES Ord(OrderID),
          ProductID   int FOREIGN KEY REFERENCES Product(ProductID),
                      CONSTRAINT OD_key PRIMARY KEY (OrderID, ProductID))
   GO
   

2. Salve o seguinte esquema em um arquivo (schema.xml):

   <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="OrderOD"
             parent="Ord"
             parent-key="OrderID"
             child="OrderDetail"
             child-key="OrderID" />
   
       <sql:relationship name="ODProduct"
             parent="OrderDetail"
             parent-key="ProductID"
             child="Product"
             child-key="ProductID" 
             inverse="true"/>
     </xsd:appinfo>
   </xsd:annotation>
   
     <xsd:element name="Order" sql:relation="Ord" 
                               sql:key-fields="OrderID" >
      <xsd:complexType>
        <xsd:sequence>
           <xsd:element name="Product" sql:relation="Product" 
                        sql:key-fields="ProductID"
                        sql:relationship="OrderOD ODProduct">
             <xsd:complexType>
                <xsd:attribute name="ProductID" type="xsd:int" />
                <xsd:attribute name="ProductName" type="xsd:string" />
             </xsd:complexType>
           </xsd:element>
        </xsd:sequence>
           <xsd:attribute name="OrderID"   type="xsd:integer" /> 
           <xsd:attribute name="CustomerID"   type="xsd:string" />
       </xsd:complexType>
     </xsd:element>
   </xsd:schema>
   

3. Salve o seguinte exemplo de documento XML em um arquivo (data.xml):

   <ROOT>  
     <Order OrderID="11" CustomerID="ALFKI">
       <Product ProductID="11" ProductName="Chai" />
       <Product ProductID="22" ProductName="Chang" />
     </Order>
     <Order OrderID="22" CustomerID="ANATR">
        <Product ProductID="33" ProductName="Aniseed Syrup" />
       <Product ProductID="44" ProductName="Gumbo Mix" />
     </Order>
   </ROOT>
   

4. Inicie o Visual Studio.

5. Crie um aplicativo de console C#.

6. No menu Projeto, selecione Adicionar Referência.

7. Na guia COM, selecione Microsoft SQLXML Bulkload 4.0 Type Library (xblkld4.dll) e clique em OK. Você consultará o assembly Interop.SQLXMLBULKLOADLib criado no projeto.

8. Substitua o método Main() pelo código a seguir. Atualize a propriedade ConnectionString e o caminho do arquivo para os arquivos de dados e esquema.

   [STAThread]
      static void Main(string[] args)
      {   
            try
            {
               SQLXMLBULKLOADLib.SQLXMLBulkLoad4Class objBL = new SQLXMLBULKLOADLib.SQLXMLBulkLoad4Class();
               objBL.ConnectionString = "Provider=sqloledb;server=server;database=databaseName;integrated security=SSPI";
               objBL.ErrorLogFile = "error.xml";
               objBL.KeepIdentity = false;
               objBL.Execute ("schema.xml","data.xml");
            }
            catch(Exception e)
            {
            Console.WriteLine(e.ToString());
            }
      }
   

9. Para carregar o XML na tabela que você criou, compile e execute o projeto.

   Observação
   A referência para o componente de Carregamento em Massa (xblkld4.dll) também pode ser acionada usando a ferramenta tlbimp.exe, que está disponível como parte da estrutura .NET. Essa ferramenta cria um wrapper gerenciado para a DLL nativa (xblkld4.dll) que pode ser usada em qualquer projeto do .NET. Por exemplo:

      c:\>tlbimp xblkld4.dll
   

   Isso cria a DLL do wrapper gerenciado (SQLXMLBULKLOADLib.dll) que você pode usar no projeto do .NET Framework. No .NET Framework, você adiciona referência de projeto à DLL recém-criada.