Oggetto SqlXmlCommand (classi gestite SQLXML)

Questo è il costruttore per l'oggetto SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Dove cnString è la stringa di connessione ADO o OLEDB che identifica il server, il database e le informazioni di accesso, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI"ad esempio .

Nella stringa di connessione deve Provider essere SQLOLEDB e Data Provider non deve essere incluso nella stringa del provider.

Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

Metodi

L'oggettoSqlXmlCommand supporta diversi metodi, inclusi i metodi seguenti per l'esecuzione di un comando:

void ExecuteNonQuery()
Esegue il comando , ma non restituisce nulla. Questo metodo è utile se si vuole eseguire un comando nonquery, ovvero un comando che non restituisce nulla. Un esempio è l'esecuzione di un updategram o di un DiffGram che aggiorna i record ma non restituisce nulla.

Stream ExecuteStream()
Restituisce un nuovo oggetto Stream. Questo metodo è utile quando si desidera che i risultati della query vengano restituiti in un nuovo flusso. Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

public void ExecuteToStream(Stream outputStream)
Scrive i risultati della query in un flusso esistente. Questo metodo è utile quando si dispone di un flusso a cui sono necessari i risultati accodati, ad esempio per fare in modo che i risultati della query vengano scritti in System.Web.HttpResponse.OutputStream. Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

XmlReader ExecuteXmlReader()
Restituisce un oggetto XmlReader. È possibile utilizzare questo metodo per modificare i dati nell'oggetto XmlReader direttamente o collegare l'architettura concatenabile di System.Xml. Per altre informazioni, vedere la documentazione di Microsoft .NET Framework. Per un esempio funzionante, vedere Esecuzione di query SQL tramite il metodo ExecuteXMLReader.

L'oggettoSqlXmlCommand supporta anche questi metodi aggiuntivi:

SqlXmlParameter CreateParameter()
Crea un oggetto SqlXmlParameter. È possibile impostare i valori per i parametri Name e Value di questo oggetto. Questo metodo è utile se si desidera passare parametri a un comando. Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

void ClearParameters()
Cancella i parametri creati per un determinato oggetto comando. Questo metodo è utile se si desidera eseguire più query sullo stesso oggetto comando.

Proprietà

L'oggetto SqlXmlCommand supporta anche queste proprietà:

ClientSideXml
Se impostato su True, specifica che la conversione del set di righe in XML deve essere eseguita sul client anziché sul server. Questa proprietà è utile quando si vuole spostare il carico delle prestazioni nel livello intermedio. La proprietà consente inoltre di eseguire il wrapping delle stored procedure esistenti con FOR XML per ottenere l'output XML.

SchemaPath
Nome dello schema di mapping insieme al percorso della directory , ad esempio C:\x\y\MySchema.xml. Questa proprietà è utile per specificare uno schema di mapping per le query XPath. Il percorso specificato può essere assoluto o relativo. Se il percorso è relativo, viene usato il percorso di base specificato in Percorso di base per risolvere il percorso relativo. Se non viene specificato alcun percorso di base, il percorso relativo è relativo alla directory corrente. Per un esempio funzionante, vedere Accesso alle funzionalità SQLXML nell'ambiente .NET.

XslPath
Nome del file XSL insieme al percorso della directory. Il percorso specificato può essere assoluto o relativo. Se il percorso è relativo, viene usato il percorso di base specificato in Percorso di base per risolvere il percorso relativo. Se non viene specificato alcun percorso di base, il percorso relativo è relativo alla directory corrente. Per un esempio funzionante, vedere Applicazione di una trasformazione XSL (classi gestite SQLXML).

Percorso di base
Percorso di base (percorso di directory). Questa proprietà è utile per risolvere un percorso relativo specificato per un file XSL (utilizzando la proprietà XslPath), un file dello schema di mapping (utilizzando la proprietà SchemaPath) o un riferimento allo schema esterno in un modello XML (specificato tramite l'attributo mapping-schema ).

OutputEncoding
Specifica la codifica per il flusso restituito durante l'esecuzione del comando. Questa proprietà è utile per richiedere una codifica specifica per il flusso restituito. Alcune codifiche comunemente usate sono UTF-8, ANSI e Unicode. UTF-8 è la codifica predefinita.

Namespace
Abilita l'esecuzione di query XPath che usano spazi dei nomi. Per altre informazioni sulle query XPath con spazi dei nomi, vedere Esecuzione di query XPath con spazi dei nomi (classi gestite SQLXML). Per un esempio funzionante, vedere Esecuzione di query XPath (classi gestite SQLXML).

RootTag
Fornisce il singolo elemento radice per XML generato dall'esecuzione del comando. Un documento XML valido richiede un singolo tag a livello radice. Se il comando eseguito genera un frammento XML (senza un singolo elemento di primo livello) è possibile specificare un elemento radice per il codice XML restituito. Per un esempio funzionante, vedere Applicazione di una trasformazione XSL (classi gestite SQLXML).

CommandText
Testo del comando. Questa proprietà viene utilizzata per specificare il testo del comando da eseguire. Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

CommandStream
Flusso di comandi. Questa proprietà è utile se si desidera eseguire un comando da un file , ad esempio un modello XML. Quando si usa CommandStream, sono supportati solo i valori " Template","UpdateGram" e "DiffGram"CommandType . Per un esempio funzionante, vedere Esecuzione di file modello tramite la proprietà CommandStream.

TipoDiComando
Identifica il tipo di comando. Questa proprietà viene utilizzata per specificare il tipo di comando da eseguire. I valori nella tabella seguente determinano il tipo di comando. Per un esempio funzionante, vedere Accesso alle funzionalità SQLXML nell'ambiente .NET.

Valore	Descrizione
SqlXmlCommandType.Sql	Esegue un comando SQL , ad esempio SELECT * FROM Employees FOR XML AUTO.
SqlXmlCommandType.XPath	Esegue un comando XPath , ad esempio Employees[@EmployeeID=1].
SqlXmlCommandType.Template	Esegue un modello XML.
SqlXmlCommandType.TemplateFile	Esegue un file modello nel percorso specificato.
SqlXmlCommandType.UpdateGram	Esegue un updategram.
SqlXmlCommandType.Diffgram	Esegue un DiffGram.

Vedere anche

Oggetto SqlXmlParameter (classi gestite SQLXML)
Oggetto SqlXmlAdapter (classi gestite SQLXML)