Kezelt SQLXML-osztályok – SqlXmlCommand objektum

A következőkre vonatkozik:SQL ServerAzure SQL Database

Ez a SqlXmlCommand objektum konstruktorja:

public SqlXmlCommand(string cnString)  

Ahol cnString az ADO vagy OLEDB kapcsolati láncsor, amely azonosítja a szervert, az adatbázist és a bejelentkezési adatokat – például Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

A kapcsolati láncban Provider SQLOLEDB-nek kell lennie, és nem Data Provider szabad szerepelni a szolgáltató stringben).

A munka mintájához lásd az SQL lekérdezések végrehajtását (SQLXML Managed Classes).

Methods

A TheSqlXmlCommand objektum több módszert támogat, beleértve a következő parancsok végrehajtására szolgáló módszereket:

void ExecuteNonQuery()
Végrehajtja a parancsot, de nem ad vissza semmit. Ez a módszer hasznos, ha nem lekérdezéses parancsot akarsz végrehajtani (vagyis olyan parancsot, amely nem ad vissza semmit). Például egy updategram vagy DiffGram futtatása, amely frissíti a rekordokat, de semmit sem ad vissza.

Stream ExecuteStream()
Egy új Stream objektumot ad vissza. Ez a módszer hasznos, ha azt szeretnéd, hogy a lekérdezés eredményeit egy új streamben kapd vissza. A munka mintájához lásd az SQL lekérdezések végrehajtását (SQLXML Managed Classes).

public void ExecuteToStream (Stream outputStream)
A lekérdezés eredményeit egy meglévő folyamba írja le. Ez a módszer akkor hasznos, ha van egy folyamod, amelyhez az eredményeket hozzá kell csatolni (például hogy a lekérdezés eredményeit a System.Web.HttpResponse.OutputStream formátumra írják). A munka mintájához lásd az SQL lekérdezések végrehajtását (SQLXML Managed Classes).

XmlReader ExecuteXmlReader()
XmlReader objektumot ad vissza. Ezt a módszert közvetlenül az XmlReader objektumban történő adatok kezelésére vagy a System.Xml láncolható architektúrájának csatlakoztatására is használhatod. További információért lásd a Microsoft .NET Framework dokumentációját. Munkamintáért lásd: SQL lekérdezések végrehajtása az ExecuteXMLReader Method használatával.

A TheSqlXmlCommand objektum ezeket a további módszereket is támogatja:

SqlXmlParameter CreateParameter()
Létrehoz egy SqlXmlParameter objektumot. Be tudod állítani ennek az objektumnak a név - és értékparamétereit . Ez a módszer hasznos, ha paramétereket akarsz átadni egy parancsnak. A munka mintájához lásd az SQL lekérdezések végrehajtását (SQLXML Managed Classes).

void ClearParameters()
Törli azokat a paramétereket(ek), amelyeket egy adott parancsobjektumhoz hoztak létre. Ez a módszer hasznos, ha több lekérdezést akarsz végrehajtani ugyanazon parancsobjektumon.

Tulajdonságok

A SqlXmlCommand objektum ezeket a tulajdonságokat is támogatja:

ClientSideXml
Ha True-ra állítják, megadja, hogy a sorhalmaz XML-re történő átalakítása kliensen történik, nem pedig a szerveren. Ez a tulajdonság akkor hasznos, ha a teljesítményterhelést a középső szintre akarod áthelyezni. A tulajdonság lehetővé teszi azt is, hogy a meglévő tárolt eljárásokat FOR XML-rel csomagolj, hogy XML kimenetet kapj.

SchemaPath
A leképezési séma neve és a könyvtár útja (például C:\x\y\MySchema.xml). Ez a tulajdonság hasznos az XPath lekérdezésekhez való leképezési séma meghatározására. A megadott út lehet abszolút vagy relatív is. Ha az út relatív jellegű, akkor az alapút által meghatározott alapút feloldja a relatív útot. Ha nincs megjelölve alapútvonal, akkor a relatív út a jelenlegi könyvtárhoz viszonyítható. Munka minta esetén lásd: Az SQLXML funkciók elérése a .NET környezetben.

XslPath
Az XSL fájl neve és a könyvtár útja. A megadott út lehet abszolút vagy relatív is. Ha az út relatív jellegű, akkor az alapút által meghatározott alapút feloldja a relatív útot. Ha nincs megjelölve alapútvonal, akkor a relatív út a jelenlegi könyvtárhoz viszonyítható. Munka mintáért lásd: Az XSL transzformáció alkalmazása (SQLXML Managed Classes).

Alapút
Az alap út (egy könyvtár út). Ez a tulajdonság hasznos egy relatív út feloldásához, amelyet egy XSL fájlra (az XslPath tulajdonság használatával), egy leképezési sémafájlra (a SchemaPath tulajdonság használatával), vagy egy külső sémahivatkozásra egy XML sablonban (a mapping-séma attribútummal megadva).

OutputEncoding
Megadja az adatfolyam kódolását, amely a parancs végrehajtásakor visszatér. Ez a tulajdonság hasznos egy adott kódolás kérésére a visszaadott áramlathoz. Néhány leggyakrabban használt kódolás az UTF-8, ANSI és Unicode. Az alapértelmezett kódolás az UTF-8.

Namespaces
Lehetővé teszi az XPath lekérdezések futtatását, amelyek névtereket használnak. További információért az XPath lekérdezésekről névtérekkel lásd : XPath lekérdezések végrehajtása névtérekkel (SQLXML Managed Classes). Működő mintaként lásd: XPath lekérdezések végrehajtása (SQLXML Managed Classes).

RootTag
Biztosítja az XML egyetlen gyökérelemét az XML-hez, amelyet parancs végrehajtásával generálnak. Egy érvényes XML dokumentumhoz egyetlen gyökérszintű címkét kell használni. Ha a végrehajtott parancs XML fragmentumot generál (egyetlen felső szintű elem nélkül), akkor beállíthatsz egy gyökérelemet a visszatérő XML-hez. Munka mintáért lásd: Az XSL transzformáció alkalmazása (SQLXML Managed Classes).

CommandText
A parancs szövege. Ez a tulajdonság a végrehajtandó parancs szövegének megadására szolgál. A munka mintájához lásd az SQL lekérdezések végrehajtását (SQLXML Managed Classes).

CommandStream
A parancsfolyam. Ez a tulajdonság hasznos, ha egy fájlból (például XML sablonból) akarsz parancsot végrehajtani. Amikor CommandStreamet használsz, csak a "Template", "UpdateGram" és "DiffGram" CommandType értékek támogatottak. Munka esetén lásd: Sablonfájlok végrehajtása a CommandStream tulajdonság használatával.

CommandType
Azonosítja a parancs típusát. Ez a tulajdonság arra szolgál, hogy meghatározza, milyen típusú parancsot szeretnénk végrehajtani. Az alábbi táblázat értékei határozzák meg a parancs típusát. Munka minta esetén lásd: Az SQLXML funkciók elérése a .NET környezetben.

Érték	Description
SqlXmlCommandType.Sql	SQL parancsot hajt végre (például, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Egy XPath parancsot hajt végre (például, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	XML sablont futtat.
SqlXmlCommandType.TemplateFile	A megadott úton futtat egy sablonfájlt.
SqlXmlCommandType.UpdateGram	Végrehajt egy updategramot.
SqlXmlCommandType.Diffgram	Végrehajt egy DiffGramot.

Lásd még:

SqlXmlParameter Object (SQLXML Managed Classes)
SqlXmlAdapter Object (SQLXML Managed Classes)