Oggetto SqlXmlCommand (classi gestite SQLXML)
Di seguito viene indicato il costruttore dell'oggetto SqlXmlCommand:
public SqlXmlCommand(string cnString)
Dove cnString è la stringa di connessione ADO o OLEDB che identifica le informazioni su server, database e accesso, ad esempio Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".
Nella stringa di connessione Provider deve essere SQLOLEDB e Data Provider non deve essere incluso nella stringa del provider.
Per un esempio reale, vedere Esecuzione di query SQL (classi gestite SQLXML).
Metodi
L'oggetto SqlXmlCommand supporta diversi metodi, inclusi quelli indicati di seguito 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 reale, 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 si desidera vengano aggiunti i risultati, ad esempio per fare in modo che i risultati della query vengano scritti in System.Web.HttpResponse.OutputStream. Per un esempio reale, vedere Esecuzione di query SQL (classi gestite SQLXML).XmlReader ExecuteXmlReader()
Restituisce un oggetto XmlReader. È possibile utilizzare questo metodo per modificare i dati direttamente nell'oggetto XmlReader o per collegare l'architettura concatenabile di System.Xml. Per ulteriori informazioni, vedere la documentazione di Microsoft .NET Framework. Per un esempio reale, vedere Esecuzione di query SQL tramite il metodo ExecuteXMLReader.
L'oggetto SqlXmlCommand supporta inoltre i metodi aggiuntivi seguenti:
SqlXmlParameter CreateParameter()
Crea un oggetto SqlXmlParameter. È possibile impostare valori per i parametri Name e Value dell'oggetto. Questo metodo è utile se si desidera passare parametri a un comando. Per un esempio reale, 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 inoltre le proprietà seguenti:
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 utilizzato il percorso di base specificato in Base Path per risolvere il percorso relativo. Se non è specificato alcun percorso di base, il percorso relativo è tale rispetto alla directory corrente. Per un esempio reale, vedere Accesso alla 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 utilizzato il percorso di base specificato in Base Path per risolvere il percorso relativo. Se non è specificato alcun percorso di base, il percorso relativo è tale rispetto alla directory corrente. Per un esempio reale, vedere Applicazione di una trasformazione XSL (classi gestite SQLXML).Base Path
Percorso di base (un percorso di directory). Questa proprietà è utile per risolvere un percorso relativo specificato per un file XSL (tramite la proprietà XslPath), un file dello schema di mapping (tramite la proprietà SchemaPath) o un riferimento allo schema esterno in un modello XML (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
Consente l'esecuzione di query XPath che utilizzano spazi dei nomi. Per ulteriori informazioni sulle query XPath con spazi dei nomi, vedere Esecuzione di query XPath con spazi dei nomi (classi gestite SQLXML). Per un esempio reale, 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 reale, 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 reale, 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 utilizza CommandStream, sono supportati solo i valori "Template", "UpdateGram" e "DiffGram"CommandType . Per un esempio reale, 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 reale, vedere Accesso alla 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.
Vedere anche