Spravované třídy SQLXML – objekt SqlXmlCommand

platí pro:SQL Serverazure SQL Database

Toto je konstruktor pro objekt SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Kde cnString je ADO nebo OLEDB spojovací řetězec, který identifikuje server, databázi a přihlašovací údaje – například Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

V řetězci spojení musí být the Provider SQLOLEDB a nemělo Data Provider by být zahrnuto v řetězci poskytovatele).

Pro pracovní ukázku viz Executing SQL Queries (SQLXML Managed Classes).

Methods

Objekt TheSqlXmlCommand podporuje několik metod, včetně následujících metod pro spuštění příkazu:

void ExecuteNonQuery()
Příkaz vykoná, ale nic nevrátí. Tato metoda je užitečná, pokud chcete spustit příkaz bez dotazu (tedy příkaz, který nic nevrátí). Příkladem je spuštění updategramu nebo DiffGramu, který aktualizuje záznamy, ale nic nevrací.

Stream ExecuteStream()
Vrátí nový objekt Stream. Tato metoda je užitečná, když chcete, aby vám výsledky dotazu byly vráceny v novém streamu. Pro pracovní ukázku viz Executing SQL Queries (SQLXML Managed Classes).

public void ExecuteToStream(Stream outputStream)
Zapisuje výsledky dotazu do existujícího streamu. Tato metoda je užitečná, když máte stream, ke kterému potřebujete připojit výsledky (například aby se výsledky dotazu zapsali do System.Web.HttpResponse.OutputStream). Pro pracovní ukázku viz Executing SQL Queries (SQLXML Managed Classes).

XmlReader ExecuteXmlReader()
Vrátí objekt XmlReader. Tuto metodu můžete použít buď přímo k manipulaci s daty v objektu XmlReader, nebo k připojení chainable architektury System.Xml. Pro více informací viz dokumentace Microsoft .NET Framework. Pro pracovní ukázku viz Execution SQL Queries by Using the ExecuteXMLReader Method.

Objekt TheSqlXmlCommand také podporuje tyto další metody:

SqlXmlParameter CreateParameter()
Vytváří objekt SqlXmlParameter. Můžete nastavit hodnoty pro parametry Name a Value tohoto objektu. Tato metoda je užitečná, pokud chcete předat parametry příkazu. Pro pracovní ukázku viz Executing SQL Queries (SQLXML Managed Classes).

void ClearParameters()
Vymaže parametr(y), které byly vytvořeny pro daný příkazový objekt. Tato metoda je užitečná, pokud chcete provádět více dotazů na stejném příkazovém objektu.

Vlastnosti

Objekt SqlXmlCommand také podporuje tyto vlastnosti:

ClientSideXml
Při nastavení na True určuje, že převod řádků do XML má probíhat na klientovi, nikoli na serveru. Tato vlastnost je užitečná, když chcete přesunout výkonovou zátěž na střední úroveň. Vlastnost také umožňuje obalit stávající uložené procedury pomocí FOR XML pro získání XML výstupu.

SchemaPath
Název mapovacího schématu spolu s cestou adresáře (například C:\x\y\MySchema.xml). Tato vlastnost je užitečná pro specifikaci mapovacího schématu pro dotazy XPath. Specifikovaná cesta může být absolutní nebo relativní. Pokud je cesta relativní, použije se základní cesta specifikovaná v Základní cestě k vyřešení relativní cesty. Pokud není zadána žádná základní cesta, relativní cesta je relativní vůči aktuálnímu adresáři. Pro pracovní ukázku viz Přístup k SQLXML Functionality in the .NET Environment.

XslPath
Název souboru XSL spolu s cestou k adresáři. Specifikovaná cesta může být absolutní nebo relativní. Pokud je cesta relativní, použije se základní cesta specifikovaná v Základní cestě k vyřešení relativní cesty. Pokud není zadána žádná základní cesta, relativní cesta je relativní vůči aktuálnímu adresáři. Pro pracovní ukázku viz Aplikace XSL transformace (SQLXML Managed Classes).

Základní cesta
Základní cesta (adresářová cesta). Tato vlastnost je užitečná pro vyřešení relativní cesty specifikované pro soubor XSL (pomocí vlastnosti XslPath), soubor mapovacího schématu (pomocí vlastnosti SchemaPath) nebo externí referenci schématu v XML šabloně (specifikované pomocí atributu mapping-schema ).

Výstupní kódování
Specifikuje kódování proudu, které je vráceno při spuštění příkazu. Tato vlastnost je užitečná pro požadavek na specifické kódování pro vrácený tok. Mezi běžně používané kódování patří UTF-8, ANSI a Unicode. UTF-8 je výchozí kódování.

Jmenné prostory
Umožňuje provádění dotazů XPath, které využívají jmenné prostory. Pro více informací o dotazech XPath s jmennými prostory viz Executing XPath Queries with Namespaces (SQLXML Managed Classes). Pro pracovní ukázku viz Executing XPath Queries (SQLXML Managed Classes).

RootTag
Poskytuje jediný kořenový prvek pro XML generovaný vykonáním příkazů. Platný XML dokument vyžaduje jeden kořenový tag. Pokud příkaz generuje XML fragment (bez jediného vrcholného prvku), můžete zadat kořenový prvek pro vracející se XML. Pro pracovní ukázku viz Aplikace XSL transformace (SQLXML Managed Classes).

CommandText
Text rozkazu. Tato vlastnost slouží k určení textu příkazu, který chcete provést. Pro pracovní ukázku viz Executing SQL Queries (SQLXML Managed Classes).

CommandStream
Proud příkazů. Tato vlastnost je užitečná, pokud chcete spustit příkaz ze souboru (například XML šablony). Když používáte CommandStream, podporují se pouze hodnoty "Template","UpdateGram" a "DiffGram". Pro pracovní ukázku viz Vykonávání šablonových souborů pomocí vlastnosti CommandStream.

CommandType
Identifikuje typ příkazu. Tato vlastnost slouží k určení typu příkazu, který chcete provést. Hodnoty v následující tabulce určují typ příkazu. Pro pracovní ukázku viz Přístup k SQLXML Functionality in the .NET Environment.

Hodnota	Description
SqlXmlCommandType.SQL	Vykoná SQL příkaz (například SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Vykoná příkaz XPath (například Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Spustí XML šablonu.
SqlXmlCommandType.TemplateFile	Spustí šablonový soubor na určené cestě.
SqlXmlCommandType.UpdateGram	Spustí updategram.
SqlXmlCommandType.Diffgram	Provádí DiffGram.

Viz také

SqlXmlParameter Object (spravované třídy SQLXML)
Objekt SqlXmlAdapter (spravované třídy SQLXML)