Klasy zarządzane SQLXML — obiekt SqlXmlCommand

Dotyczy:programu SQL ServerAzure SQL Database

To jest konstruktor obiektu SqlXmlCommand:

public SqlXmlCommand(string cnString)  

Gdzie cnString jest ciągiem połączeń ADO lub OLEDB, który identyfikuje serwer, bazę danych i dane logowania – na przykład Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI".

W ciągu połączenia musi być Provider SQLOLEDB i nie Data Provider powinien być zawarty w ciągu providera).

Przykładowy opis można znaleźć w artykule Wykonanie zapytań SQL (klasy zarządzane SQLXML).

Methods

Obiekt TheSqlXmlCommand obsługuje kilka metod, w tym następujące metody wykonywania polecenia:

void ExecuteNonQuery()
Wykonuje polecenie, ale nic nie zwraca. Ta metoda jest przydatna, jeśli chcesz wykonać polecenie niezapytania (czyli polecenie, które nic nie zwraca). Przykładem jest uruchomienie updategramu lub DiffGramu, który aktualizuje rekordy, ale nic nie zwraca.

Stream ExecuteStream()
Zwraca nowy obiekt strumienia. Ta metoda jest przydatna, gdy chcesz, aby wyniki zapytań wróciły do Ci w nowym strumieniu. Przykładowy opis można znaleźć w artykule Wykonanie zapytań SQL (klasy zarządzane SQLXML).

public void ExecuteToStream(Stream outputStream)
Zapisuje wyniki zapytania do istniejącego strumienia. Ta metoda jest przydatna, gdy masz strumień, do którego musisz dodać wyniki (na przykład, aby wyniki zapytania zostały zapisane w System.Web.HttpResponse.OutputStream). Przykładowy opis można znaleźć w artykule Wykonanie zapytań SQL (klasy zarządzane SQLXML).

XmlReader WykonajXmlReader()
Zwraca obiekt XmlReader. Możesz użyć tej metody do bezpośredniej manipulacji danymi w obiekcie XmlReader lub podłączenia chainowalnej architektury System.Xml. Więcej informacji można znaleźć w dokumentacji Microsoft .NET Framework. Przykładowy opis można znaleźć w artykule Wykonywanie zapytań SQL metodą ExecuteXMLReader.

Obiekt TheSqlXmlCommand obsługuje także następujące dodatkowe metody:

SqlXmlParameter CreateParameter()
Tworzy obiekt SqlXmlParameter. Możesz ustawić wartości dla parametrów Nazwa i Wartość tego obiektu. Ta metoda jest przydatna, jeśli chcesz przekazać parametry do polecenia. Przykładowy opis można znaleźć w artykule Wykonanie zapytań SQL (klasy zarządzane SQLXML).

void ClearParameters()
Usuwa parametr(y) utworzone dla danego obiektu poleceń. Ta metoda jest przydatna, jeśli chcesz wykonać wiele zapytań na tym samym obiekcie poleceń.

Właściwości

Obiekt SqlXmlCommand obsługuje także następujące właściwości:

ClientSideXml
Gdy jest ustawiony na True, określa, że konwersja zestawu wierszy na XML ma być przeprowadzona na kliencie, a nie na serwerze. Ta właściwość jest przydatna, gdy chcesz przenieść obciążenie wydajności na średni poziom. Właściwość ta pozwala również owinąć istniejące procedury przechowywane FOR XML, aby uzyskać wyjście XML.

SchemaPath
Nazwa schematu mapowania wraz ze ścieżką katalogu (na przykład C:\x\y\MySchema.xml). Ta właściwość jest przydatna do określania schematu mapowania zapytań XPath. Określona ścieżka może być absolutna lub względna. Jeśli ścieżka jest względna, do rozwiązywania ścieżki względnej używa się ścieżki bazowej określonej w Ścieżce Bazowej. Jeśli nie podano ścieżki bazowej, ścieżka względna jest względna względem bieżącego katalogu. Przykładowy opis można znaleźć w artykule Dostęp do funkcjonalności SQLXML w środowisku .NET.

XslPath
Nazwa pliku XSL wraz ze ścieżką katalogu. Określona ścieżka może być absolutna lub względna. Jeśli ścieżka jest względna, do rozwiązywania ścieżki względnej używa się ścieżki bazowej określonej w Ścieżce Bazowej. Jeśli nie podano ścieżki bazowej, ścieżka względna jest względna względem bieżącego katalogu. Przykładowy opis można znaleźć w artykule Zastosowanie transformacji XSL (klasy zarządzane SQLXML).

Ścieżka bazy
Ścieżka bazowa (ścieżka katalogowa). Ta właściwość jest przydatna do rozwiązywania względnej ścieżki określonej dla pliku XSL (za pomocą właściwości XslPath), pliku schematu mapowania (za pomocą właściwości SchemaPath) lub zewnętrznej referencji do schematu w szablonie XML (określonym za pomocą atrybutu mapping-schema ).

Kodowanie wyjściowe
Określa kodowanie strumienia, które jest zwracane po wykonaniu polecenia. Ta właściwość jest przydatna do żądania konkretnego kodowania dla strumienia, który jest zwracany. Do najczęściej stosowanych kodów należą UTF-8, ANSI i Unicode. UTF-8 to domyślne kodowanie.

Przestrzenie nazw
Umożliwia wykonywanie zapytań XPath wykorzystujących przestrzenie nazw. Więcej informacji o zapytaniach XPath z przestrzeniami nazw można znaleźć w artykule Wykonywanie zapytań XPath z przestrzeniami nazw (klasy zarządzane SQLXML). Przykładowy opis można znaleźć w artykule Wykonanie zapytań XPath (klasy zarządzane SQLXML).

RootTag
Zapewnia pojedynczy element główny dla XML generowanego przez wykonanie poleceń. Ważny dokument XML wymaga pojedynczego tagu na poziomie głównym. Jeśli wykonane polecenie generuje fragment XML (bez pojedynczego elementu najwyższego poziomu), można określić element główny dla zwracającego się XML. Przykładowy opis można znaleźć w artykule Zastosowanie transformacji XSL (klasy zarządzane SQLXML).

Tekst polecenia
Tekst rozkazu. Ta właściwość służy do określenia tekstu polecenia, które chcesz wykonać. Przykładowy opis można znaleźć w artykule Wykonanie zapytań SQL (klasy zarządzane SQLXML).

CommandStream
Strumień dowodzenia. Ta właściwość jest przydatna, jeśli chcesz wykonać polecenie z pliku (na przykład szablonu XML). Gdy używasz CommandStream, obsługiwane są tylko wartości "Template","UpdateGram" i "DiffGram". Przykładowy element roboczy można znaleźć w artykule Wykonanie plików szablonu za pomocą właściwości CommandStream.

Typ polecenia
Identyfikuje rodzaj polecenia. Ta właściwość służy do określenia typu polecenia, które chcesz wykonać. Wartości w poniższej tabeli określają typ polecenia. Przykładowy opis można znaleźć w artykule Dostęp do funkcjonalności SQLXML w środowisku .NET.

Wartość	Description
SqlXmlCommandType.SQL	Wykonuje polecenie SQL (na przykład SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Wykonuje polecenie XPath (na przykład Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Wykonuje szablon XML.
SqlXmlCommandType.TemplateFile	Wykonuje plik szablonu na określonej ścieżce.
SqlXmlCommandType.UpdateGram	Wykonuje aktualizację.
SqlXmlCommandType.Diffgram	Wykonuje DiffGram.

Zobacz też

Obiekt SqlXmlParameter (klasy zarządzane SQLXML)
Obiekt SqlXmlAdapter (klasy zarządzane SQLXML)