Beheerde SQLXML-klassen - SqlXmlCommand-object

Van toepassing op:SQL ServerAzure SQL Database

Dit is de constructor voor het SqlXmlCommand-object:

public SqlXmlCommand(string cnString)  

Waar cnString de ADO of OLEDB verbindingsstring is die de server, database en de inloggegevens identificeert – bijvoorbeeld, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

In de verbindingsstring moet SQLOLEDB Provider zijn en moet niet Data Provider in de providerstring worden opgenomen).

Voor een werkvoorbeeld, zie Executing SQL Queries (SQLXML Managed Classes).

Methods

Het SqlXmlCommand-object ondersteunt verschillende methoden, waaronder de volgende methoden voor het uitvoeren van een commando:

void ExecuteNonQuery()
Voert het commando uit, maar geeft niets terug. Deze methode is nuttig als je een nonquery-commando wilt uitvoeren (dat wil zeggen, een commando dat niets teruggeeft). Een voorbeeld is het uitvoeren van een updategram of een DiffGram die records bijwerkt maar niets teruggeeft.

Stream ExecuteStream()
Geeft een nieuw Stream-object terug. Deze methode is handig wanneer je wilt dat de zoekresultaten in een nieuwe stream worden teruggestuurd. Voor een werkvoorbeeld, zie Executing SQL Queries (SQLXML Managed Classes).

public void ExecuteToStream(Stream outputStream)
Schrijft de zoekresultaten naar een bestaande stream. Deze methode is nuttig wanneer je een stream hebt waaraan je de resultaten wilt toevoegen (bijvoorbeeld om de zoekresultaten te laten schrijven naar System.Web.HttpResponse.OutputStream). Voor een werkvoorbeeld, zie Executing SQL Queries (SQLXML Managed Classes).

XmlReader ExecuteXmlReader()
Geeft een XmlReader-object terug. Je kunt deze methode gebruiken om data in het XmlReader-object direct te manipuleren of de chainable architectuur van System.Xml in te pluggen. Voor meer informatie, zie de documentatie van het Microsoft .NET Framework. Voor een werkvoorbeeld, zie Executing SQL Queries met behulp van de ExecuteXMLReader Method.

Het object TheSqlXmlCommand ondersteunt ook deze extra methoden:

SqlXmlParameter CreateParameter()
Maakt een SqlXmlParameter-object aan. Je kunt waarden instellen voor de Naam- en Waardeparameters van dit object. Deze methode is handig als je parameters aan een commando wilt doorgeven. Voor een werkvoorbeeld, zie Executing SQL Queries (SQLXML Managed Classes).

void ClearParameters()
Cleart parameter(s) die zijn aangemaakt voor een bepaald commando-object. Deze methode is handig als je meerdere queries op hetzelfde commando-object wilt uitvoeren.

Eigenschappen

Het SqlXmlCommand-object ondersteunt ook deze eigenschappen:

ClientSideXml
Wanneer ingesteld op True, specificeert dit dat de conversie van de rijset naar XML op de client moet plaatsvinden in plaats van op de server. Deze eigenschap is handig wanneer je de prestatiebelasting naar de middenklasse wilt verplaatsen. De eigenschap stelt je ook in staat om bestaande opgeslagen procedures te omhullen met FOR XML om XML-output te verkrijgen.

SchemaPath
De naam van het mappingschema samen met het directorypad (bijvoorbeeld C:\x\y\MySchema.xml). Deze eigenschap is nuttig voor het specificeren van een mappingschema voor XPath-queries. Het gespecificeerde pad kan absoluut of relatief zijn. Als het pad relatief is, wordt het basispad dat in Basispad is gespecificeerd gebruikt om het relatieve pad op te lossen. Als er geen basispad is gespecificeerd, is het relatieve pad relatief aan de huidige directory. Voor een werkvoorbeeld, zie Toegang tot SQLXML-functionaliteit in de .NET-omgeving.

XslPath
De naam van het XSL-bestand samen met het mappad. Het gespecificeerde pad kan absoluut of relatief zijn. Als het pad relatief is, wordt het basispad dat in Basispad is gespecificeerd gebruikt om het relatieve pad op te lossen. Als er geen basispad is gespecificeerd, is het relatieve pad relatief aan de huidige directory. Voor een werkvoorbeeld, zie Applying an XSL Transformation (SQLXML Managed Classes).

Basispad
Het basispad (een directorypad). Deze eigenschap is nuttig voor het oplossen van een relatief pad dat is gespecificeerd voor een XSL-bestand (door gebruik te maken van de XslPath-eigenschap), een mapping schema-bestand (door de SchemaPath-eigenschap) of een externe schemareferentie in een XML-sjabloon (gespecificeerd met het mapping-schema-attribuut ).

OutputEncoding
Specificeert de codering voor de stroom die wordt teruggegeven wanneer het commando wordt uitgevoerd. Deze eigenschap is nuttig om een specifieke codering voor de stream die wordt teruggegeven aan te vragen. Enkele veelgebruikte coderingen zijn UTF-8, ANSI en Unicode. UTF-8 is de standaardcodering.

Naamruimten
Maakt de uitvoering mogelijk van XPath-queries die namespaces gebruiken. Voor meer informatie over XPath-queries met namespaces, zie Executing XPath Queries with Namespaces (SQLXML Managed Classes). Voor een werkvoorbeeld, zie Executing XPath Queries (SQLXML Managed Classes).

RootTag
Biedt het enkele root-element voor XML die door commando-uitvoering wordt gegenereerd. Een geldig XML-document vereist één enkel root-level tag. Als het uitgevoerde commando een XML-fragment genereert (zonder één enkel top-level element), kun je een root-element specificeren voor de terugkerende XML. Voor een werkvoorbeeld, zie Applying an XSL Transformation (SQLXML Managed Classes).

CommandText
De tekst van het commando. Deze eigenschap wordt gebruikt om de tekst van het commando dat je wilt uitvoeren te specificeren. Voor een werkvoorbeeld, zie Executing SQL Queries (SQLXML Managed Classes).

CommandStream
De commandostroom. Deze eigenschap is handig als je een commando uit een bestand wilt uitvoeren (bijvoorbeeld een XML-sjabloon). Wanneer je CommandStream gebruikt, worden alleen waarden van "Template","UpdateGram" en "DiffGram" CommandType ondersteund. Voor een werkvoorbeeld, zie Uitvoeren van Sjabloonbestanden door de CommandStream-eigenschap te gebruiken.

CommandType
Identificeert het type commando. Deze eigenschap wordt gebruikt om het type commando dat je wilt uitvoeren te specificeren. De waarden in de volgende tabel bepalen het type van het commando. Voor een werkvoorbeeld, zie Toegang tot SQLXML-functionaliteit in de .NET-omgeving.

Waarde	Description
SqlXmlCommandType.Sql	Voert een SQL-commando uit (bijvoorbeeld SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Voert een XPath-commando uit (bijvoorbeeld Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Voert een XML-sjabloon uit.
SqlXmlCommandType.TemplateFile	Voert een sjabloonbestand uit op het opgegeven pad.
SqlXmlCommandType.UpdateGram	Voert een updategram uit.
SqlXmlCommandType.Diffgram	Voert een DiffGram uit.

Zie ook

SqlXmlParameter Object (SQLXML beheerde klassen)
SqlXmlAdapter Object (SQLXML beheerde klassen)