Executando consultas SQL (classes gerenciadas SQLXML)

Este exemplo demonstra como:

• Criar parâmetros (objetos SqlXmlParameter).

• Atribuir valores às propriedades (Name e Value) de objetos SqlXmlParameter.

Neste exemplo, uma consulta SQL simples é executada para recuperar o nome, o sobrenome e a data de nascimento do funcionário cujo valor de sobrenome é passado como parâmetro. Ao especificar o parâmetro (LastName), somente a propriedade Value é definida. A propriedade Name não é definida, porque nessa consulta o parâmetro é posicional e nenhum nome é necessário.

A propriedade CommandType do objeto SqlXmlCommand por padrão é Sql. Portanto, a propriedade não é definida explicitamente.

Observação
No código, é necessário fornecer o nome da instância do Microsoft SQL Server na cadeia de conexão.

Este é o código C#:

using System;

using Microsoft.Data.SqlXml;
using System.IO;
class Test
{
      static string ConnString = "Provider=SQLOLEDB;Server=(local);database=AdventureWorks;Integrated Security=SSPI";
      public static int testParams()
      {
         Stream strm;
         SqlXmlParameter p;
         SqlXmlCommand cmd = new SqlXmlCommand(ConnString);      
         cmd.CommandText = "SELECT FirstName, LastName FROM Person.Contact WHERE LastName=? For XML Auto";
         p = cmd.CreateParameter();
         p.Value = "Achong";
         string strResult;
         try 
         {
            strm = cmd.ExecuteStream();
            strm.Position = 0;
            using(StreamReader sr = new StreamReader(strm))
            {
               Console.WriteLine(sr.ReadToEnd());
            }
         }
         catch (SqlXmlException e)
         {
            //in case of an error, this prints error returned.
            e.ErrorStream.Position=0;
            strResult=new StreamReader(e.ErrorStream).ReadToEnd();
            System.Console.WriteLine(strResult);
         }
         
         return 0;
   }
public static int Main(String[] args)
{
    testParams();
    return 0;
}
}

Para testar o aplicativo

1. Salve o código C# (DocSample.cs) fornecido neste tópico em uma pasta.

2. Compile o código. Para compilar o código no prompt de comando, use:

   csc /reference:Microsoft.Data.SqlXML.dll DocSample.cs
   

   Isso cria um executável (DocSample.exe).

3. No prompt de comando, execute DocSample.exe.

Em vez de especificar consultas SQL como o texto de comando, você pode especificar um modelo (conforme mostrado no fragmento de código a seguir) que executa um diagrama de atualização (que também é um modelo) para inserir um registro de cliente. Você pode especificar modelos e diagramas de atualização em arquivos e também executar arquivos. Para obter mais informações, consulte Executando os arquivos de modelo usando a propriedade CommandText.

   SqlXmlCommand cmd = new SqlXmlCommand("Provider=SQLOLEDB;Data Source=SqlServerName;Initial Catalog=Database; Integrated Security=SSPI;");
   Stream stm;
   cmd.CommandType = SqlXmlCommandType.UpdateGram;
   cmd.CommandText = "<ROOT xmlns:sql='urn:schemas-microsoft-com:xml-sql' xmlns:updg='urn:schemas-microsoft-com:xml-updategram'>" +
         "<updg:sync>" +
          "<updg:before/>" +
          "<updg:after>" +
            "<Customer CustomerID='aaaaa' CustomerName='Some Name' CustomerTitle='SomeTitle' />" +
          "</updg:after>" +
          "</updg:sync>" +
          "</ROOT>";

   stm = cmd.ExecuteStream();
   stm = null;
   cmd = null;

Usando ExecuteToStream

Se houver um fluxo existente, você poderá usar o método ExecuteToStream em vez de criar um objeto Stream e usar o método Execute. O código do exemplo anterior está revisado a seguir para usar o método ExecuteToStream:

using System;
using Microsoft.Data.SqlXml;
using System.IO;
class Test
{
   static string ConnString = "Provider=SQLOLEDB;Server=SqlServerName;database=AdventureWorks;Integrated Security=SSPI;";
   public static int testParams()
   {
      SqlXmlParameter p;
      MemoryStream ms = new MemoryStream();
      StreamReader sr = new StreamReader(ms);
      ms.Position = 0;
      SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
      cmd.CommandText = "select FirstName, LastName from Person.Contact where LastName = ? For XML Auto";
      p = cmd.CreateParameter();
      p.Value = "Achong";
      cmd.ExecuteToStream(ms);
      ms.Position = 0;
      Console.WriteLine(sr.ReadToEnd());
      return 0;      
   }
   public static int Main(String[] args)
   {
      testParams();   
      return 0;
   }
}

Observação
Você também pode usar o método ExecuteXMLReader que retorna um objeto XmlReader. Para obter mais informações, consulte Executando consultas SQL usando o método ExecuteXMLReader.