Condividi tramite

Classi gestite SQLXML - Oggetto SqlXmlCommand

  • Articolo

Si applica a: SQL Server Database SQL di Azure

Questo è il costruttore per l'oggetto SqlXmlCommand:

public SqlXmlCommand(string cnString)

Dove cnString è il 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 Provider deve 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 alcun valore. Questo metodo è utile se si desidera eseguire un comando senza query, ovvero un comando che non restituisca alcun valore. Un esempio di questo comportamento consiste nell'eseguire un updategram o un Diffgram che aggiorna record ma non restituisce alcun valore.

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 oggetto comando specifico. Questo metodo è utile se si desidera eseguire più query sullo stesso oggetto comando.

Proprietà

L'oggetto SqlXmlCommand supporta anche queste proprietà:

ClientSideXml
Se impostata su True, specifica che la conversione del set di righe in XML deve verificarsi nel client anziché nel server. Questa proprietà è utile quando si desidera 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 output XML.

SchemaPath
Nome dello schema di mapping insieme al percorso di directory, ad esempio C:\x\y\Schema.xml. Questa proprietà è utile per specificare uno schema di mapping per 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 è specificato alcun percorso di base, il percorso relativo è tale rispetto alla directory corrente. Per un esempio funzionante, vedere Accesso alle funzionalità SQLXML nell'ambiente .NET.

XslPath
Nome del file XSL insieme al percorso di 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 è specificato alcun percorso di base, il percorso relativo è tale rispetto alla directory corrente. Per un esempio funzionante, vedere Applicazione di una trasformazione XSL (classi gestite SQLXML).

Percorso base
Percorso di base (un 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 (tramite 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 all'esecuzione del comando. Questa proprietà è utile per richiedere una codifica specifica per il flusso restituito. Alcune codifiche di uso comune sono UTF-8, ANSI e Unicode. La codifica predefinita è UTF-8.

Namespaces (Spazi dei nomi)
Consente l'esecuzione di query XPath che utilizzano 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 un documento XML generato dall'esecuzione di comandi. Un documento XML valido richiede un singolo tag di livello radice. Se il comando eseguito genera un frammento XML, senza singolo elemento di livello principale, è possibile specificare un elemento radice per il documento 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 che si desidera eseguire. Per un esempio funzionante, vedere Esecuzione di query SQL (classi gestite SQLXML).

CommandStream
Flusso del comando. 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.

CommandType
Identifica il tipo di comando. Questa proprietà viene utilizzata per specificare il tipo di comando che si desidera eseguire. I valori nella tabella seguente determinano il tipo del 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 di modello nel percorso specificato.
SqlXmlCommandType.UpdateGram Esegue un updategram.
SqlXmlCommandType.Diffgram Esegue un Diffgram.

Vedi anche

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