SQLXML-hanterade klasser – SqlXmlCommand-objekt

gäller för:SQL ServerAzure SQL Database

Detta är konstruktorn för objektet SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Där cnString är ADO- eller OLEDB-anslutningssträngen som identifierar servern, databasen och inloggningsinformationen – till exempel Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

I anslutningssträngen måste det Provider vara SQLOLEDB och bör Data Provider inte inkluderas i leverantörssträngen).

För ett fungerande exempel, se Executing SQL Queries (SQLXML Managed Classes).

Methods

Objektet TheSqlXmlCommand stöder flera metoder, inklusive följande metoder för att exekvera ett kommando:

void ExecuteNonQuery()
Utför kommandot, men ger inget tillbaka. Denna metod är användbar om du vill köra ett icke-fråga-kommando (det vill säga ett kommando som inte returnerar något). Ett exempel är att köra ett updategram eller en DiffGram som uppdaterar poster men inte returnerar något.

Stream ExecuteStream()
Returnerar ett nytt Stream-objekt. Denna metod är användbar när du vill att sökresultaten ska returneras till dig i en ny ström. För ett fungerande exempel, se Executing SQL Queries (SQLXML Managed Classes).

public void ExecuteToStream(Stream outputStream)
Skriver frågeresultaten till en befintlig ström. Denna metod är användbar när du har en ström där du behöver få resultaten tillagda (till exempel för att få frågeresultaten skrivna till System.Web.HttpResponse.OutputStream). För ett fungerande exempel, se Executing SQL Queries (SQLXML Managed Classes).

XmlReader ExecuteXmlReader()
Returnerar ett XmlReader-objekt. Du kan använda denna metod för att antingen manipulera data direkt i XmlReader-objektet eller koppla in den kedjebara arkitekturen för System.Xml. För mer information, se dokumentationen för Microsoft .NET Framework. För ett arbetsexempel, se Körning av SQL-frågor med hjälp av ExecuteXMLReader-metoden.

TheSqlXmlCommand-objektet stöder också dessa ytterligare metoder:

SqlXmlParameter CreateParameter()
Skapar ett SqlXmlParameter-objekt. Du kan ställa in värden för Namn- och Värdeparametrarna för detta objekt. Denna metod är användbar om du vill skicka parametrar till ett kommando. För ett fungerande exempel, se Executing SQL Queries (SQLXML Managed Classes).

void ClearParameter()
Rensar parametrar som skapats för ett givet kommandoobjekt. Denna metod är användbar om du vill köra flera frågor på samma kommandoobjekt.

Egenskaper

Objektet SqlXmlCommand stöder också dessa egenskaper:

ClientSideXml
När den sätts till True specificeras att konverteringen av raduppsättningen till XML ska ske på klienten istället för på servern. Denna egenskap är användbar när du vill flytta prestandabelastningen till mellannivån. Egenskapen tillåter dig också att omslå befintliga lagrade procedurer med FOR XML för att få XML-utdata.

SchemaPath
Namnet på mappningsschemat tillsammans med katalogvägen (till exempel C:\x\y\MySchema.xml). Denna egenskap är användbar för att specificera ett mappningsschema för XPath-frågor. Den väg som anges kan vara absolut eller relativ. Om vägen är relativ används basvägen som anges i Basvägen för att lösa den relativa vägen. Om ingen basväg anges är den relativa sökvägen relativ till den aktuella katalogen. För ett arbetsexempel, se Access SQLXML Functionality in the .NET Environment.

XslPath
Namnet på XSL-filen tillsammans med katalogvägen. Den väg som anges kan vara absolut eller relativ. Om vägen är relativ används basvägen som anges i Basvägen för att lösa den relativa vägen. Om ingen basväg anges är den relativa sökvägen relativ till den aktuella katalogen. För ett arbetsexempel, se Applying an XSL Transformation (SQLXML Managed Classes).

Basväg
Basvägen (en katalogväg). Denna egenskap är användbar för att lösa en relativ väg som specificeras för en XSL-fil (genom att använda XslPath-egenskapen), en mappningsschemafil (genom att använda SchemaPath-egenskapen) eller en extern schemareferens i en XML-mall (specificerad genom att använda mapping-schema-attributet ).

OutputEncoding
Specificerar kodningen för strömmen som returneras när kommandot exekveras. Denna egenskap är användbar för att begära en specifik kodning för strömmen som returneras. Några vanliga kodningar är UTF-8, ANSI och Unicode. UTF-8 är standardkodningen.

Namnområden
Möjliggör körning av XPath-frågor som använder namnrymder. För mer information om XPath-frågor med namnrymder, se Exekvering av XPath-frågor med namnrymder (SQLXML Managed Classes). För ett arbetsexempel, se Körning av XPath-frågor (SQLXML Managed Classes).

RootTag
Tillhandahåller det enda rotelementet för XML som genereras av kommandoexekvering. Ett giltigt XML-dokument kräver en enda rotnivåtagg. Om kommandot som körs genererar ett XML-fragment (utan ett enda toppnivåelement) kan du ange ett rotelement för den returnerande XML:en. För ett arbetsexempel, se Applying an XSL Transformation (SQLXML Managed Classes).

CommandText
Texten i kommandot. Denna egenskap används för att specificera texten till kommandot du vill utföra. För ett fungerande exempel, se Executing SQL Queries (SQLXML Managed Classes).

CommandStream
Kommandoströmmen. Denna egenskap är användbar om du vill köra ett kommando från en fil (till exempel en XML-mall). När du använder CommandStream stöds endast värden "Template","UpdateGram" och "DiffGram"CommandType . För ett fungerande exempel, se Köra mallfiler med hjälp av egenskapen CommandStream.

CommandType
Identifierar typen av kommando. Denna egenskap används för att specificera vilken typ av kommando du vill utföra. Värdena i följande tabell bestämmer typen av kommandot. För ett arbetsexempel, se Access SQLXML Functionality in the .NET Environment.

Värde	Description
SqlXmlCommandType.Sql	Utför ett SQL-kommando (till exempel SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Utför ett XPath-kommando (till exempel Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Kör en XML-mall.
SqlXmlCommandType.TemplateFile	Kör en mallfil på den angivna sökvägen.
SqlXmlCommandType.UpdateGram	Kör ett updategram.
SqlXmlCommandType.Diffgram	Utför en DiffGram.

Se även

SqlXmlParameter-objekt (SQLXML hanterade klasser)
SqlXmlAdapter-objekt (SQLXML Managed Classes)