Esecuzione di query SQL (classi gestite SQLXML)
Si applica a: SQL Server database SQL di Azure
In questo esempio vengono illustrate le operazioni seguenti:
Creazione di parametri (oggetti SqlXmlParameter).
Assegnazione di valori alle proprietà (Name e Value) degli oggetti SqlXmlParameter.
In questo esempio viene eseguita una query SQL semplice per recuperare il nome, il cognome e la data di nascita del dipendente il cui valore di cognome viene passato come parametro. Se si specifica il parametro (LastName), viene impostata solo la proprietà Value. La proprietà Name non è impostata, perché in questa query il parametro è posizionale e non è necessario alcun nome.
La proprietà CommandType dell'oggetto SqlXmlCommand per impostazione predefinita è Sql. La proprietà, pertanto, non viene impostata in modo esplicito.
Nota
Nel codice è necessario specificare il nome dell'istanza di Microsoft SQL Server nel stringa di connessione.
Di seguito viene fornito il codice 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;
}
}
Per testare l'applicazione
Salvare in una cartella il codice C# (DocSample.cs) fornito in questo argomento.
Compilare il codice. Per compilare il codice al prompt dei comandi, utilizzare:
csc /reference:Microsoft.Data.SqlXML.dll DocSample.cs
Viene creato un file eseguibile (DocSample.exe).
Al prompt dei comandi eseguire DocSample.exe.
Per testare questo esempio, è necessario che Microsoft .NET Framework sia installato nel computer.
Anziché specificare query SQL come testo del comando, è possibile specificare un modello, come illustrato nel frammento di codice seguente, che esegua un updategram (che è anche un modello) per inserire un record del consumer. È possibile specificare modelli e updategram in file e file di esecuzione. Per altre informazioni, vedere Esecuzione di file modello tramite la proprietà 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;
Utilizzo di ExecuteToStream
Se si dispone di un flusso esistente, è possibile usare il metodo ExecuteToStream anziché creare un oggetto Stream e usare il metodo Execute. Il codice dell'esempio precedente viene rivisto qui per usare il metodo 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;
}
}
Nota
È anche possibile utilizzare il metodo ExecuteXMLReader che restituisce un oggetto XmlReader. Per altre informazioni, vedere Esecuzione di query SQL tramite il metodo ExecuteXMLReader.