Obiekt SqlXmlCommand (klasy Managed SQLXML)

Metody

TheSqlXmlCommand object supports several methods, including the following methods for executing a command:

• void ExecuteNonQuery()
  Wykonuje polecenie, ale nie zwraca żadnych.Ta metoda jest przydatna w przypadku wykonać polecenia nonquery (to znaczy polecenia, które nie zwraca żadnych).Przykładem jest wykonywana updategram lub w formacie DiffGram, aktualizuje rekordy, ale nic nie zwraca.

• Stream ExecuteStream()
  Zwraca nowy Stream obiekt. Ta metoda jest przydatna, jeśli chcesz, aby wyniki kwerendy, zwracane w postaci nowego strumienia.Przykładowy pracy zobacz Wykonywanie kwerendy SQL (klasy Managed SQLXML).

• public void ExecuteToStream(Stream outputStream)
  Zapisuje wyniki kwerendy istniejących strumienia.Ta metoda jest użyteczna wówczas, gdy strumień, do której konieczne jest dołączany wyniki (na przykład, aby kwerenda wyników zapisane System.Web.HttpResponse.OutputStream). Przykładowy pracy zobacz Wykonywanie kwerendy SQL (klasy Managed SQLXML).

• XmlReader ExecuteXmlReader()
  Zwraca XmlReader obiekt. Ta metoda umożliwia albo manipulowania danymi w XmlReader obiekt bezpośrednio lub podłącz chainable architektury System.Xml. Aby uzyskać więcej informacji, zobacz temat Microsoft Dokumentacja systemu .NET framework. Przykładowy pracy zobacz Wykonywanie kwerendy SQL przy użyciu metoda ExecuteXMLReader.

TheSqlXmlCommand object also supports these additional methods:

• SqlXmlParameter CreateParameter()
  Tworzy SqlXmlParameter obiekt. zestaw wartości dla Name i Value Parametry tego obiektu. Ta metoda jest przydatna, jeśli chcesz przekazać parametry polecenia.Przykładowy pracy zobacz Wykonywanie kwerendy SQL (klasy Managed SQLXML).

• void ClearParameters()
  Czyści parametrów, które zostały utworzone dla obiektu danego polecenia.Ta metoda jest przydatna, jeśli chcesz wykonywać wiele kwerendy dla tego samego obiektu polecenie.

Właściwości

The SqlXmlCommand object also supports these properties:

• ClientSideXml
  Po ustawieniu na wartość true, określa, że konwersja zestaw wierszy do formatu XML ma występować klient, a nie na serwerze.Ta właściwość jest przydatna, gdy użytkownik chce przenieść obciążenia wydajności warstwa środkowa.Właściwość umożliwia również zawijanie istniejące procedury przechowywane za pomocą języka XML na uzyskanie dane wyjściowe XML.

• SchemaPath
  Nazwa schematu mapowania wraz ze ścieżka katalogu (na przykład C:\x\y\MySchema.xml).Właściwość ta jest użyteczna w przypadku określania mapowania schematu dla kwerend XPath.Ścieżka, która została określona może być względny lub bezwzględny.Jeśli ścieżka jest względna, ścieżki bazowej, określoną w oknie Base Path Służy do rozpoznawania ścieżki względnej. Jeśli żadna ścieżka podstawowa nie zostanie określona, ścieżka względna jest względna w stosunku do bieżącego katalogu.Przykładowy pracy zobacz Dostęp do funkcjonalności SQLXML w środowisku .NET.

• XslPath
  Nazwa pliku XSL wraz ze ścieżka katalogu.Ścieżka, która została określona może być względny lub bezwzględny.Jeśli ścieżka jest względna, ścieżki bazowej, określoną w oknie Base Path Służy do rozpoznawania ścieżki względnej. Jeśli żadna ścieżka podstawowa nie zostanie określona, ścieżka względna jest względna w stosunku do bieżącego katalogu.Przykładowy pracy zobacz Stosowanie transformacja XSL (klasy Managed SQLXML).

• Base Path
  Ścieżki bazowej (ścieżka katalogu).Ta właściwość jest przydatna do rozwiązywania problemów ze ścieżka względną, który został określony dla pliku XSL (przy użyciu XslPath Właściwość), pliku mapowania schematu (przy użyciu SchemaPath Właściwość) lub odwołaniem do zewnętrznego schematu w szablonie wiadomości XML (określona przy użyciu mapping-schema atrybut).

• OutputEncoding
  Określa kodowanie strumienia, który jest zwracany, gdy wykonuje polecenie.Ta właściwość jest przydatna do żądania określonego kodowania dla strumienia, który jest zwracany.Niektóre powszechnie używane kodowania jest UTF-8, ANSI i Unicode.Ustawieniem domyślnym jest UTF-8 kodowania.

• Namespaces
  Umożliwia wykonanie kwerendy XPath, używające obszarów nazw.Aby uzyskać więcej informacji na temat kwerend XPath z obszarami nazw Zobacz Wykonywanie kwerend XPath za pomocą obszarów nazw (klasy Managed SQLXML). Przykładowy pracy zobacz Wykonywanie kwerendy XPath (klasy Managed SQLXML).

• RootTag
  Zawiera element główny jednego XML wygenerowany przez wykonanie polecenia.Prawidłowe dokumenty XML wymaga pojedynczego tagu poziomie katalogu głównego.Jeśli polecenie, wykonane generuje fragmentu XML (bez pojedynczy element najwyższego poziom) przekazujące dane XML, można określić elementu głównego.Przykładowy pracy zobacz Stosowanie transformacja XSL (klasy Managed SQLXML).

• CommandText
  Tekst polecenia.Ta właściwość jest używana do określania tekst polecenia, które chcesz wykonać.Przykładowy pracy zobacz Wykonywanie kwerendy SQL (klasy Managed SQLXML).

• CommandStream
  Strumień polecenia.Ta właściwość jest przydatna w przypadku wykonać polecenia z pliku (na przykład szablonu XML).W przypadku korzystania z CommandStream, tylko "Szablon", "UpdateGram" and "W formacie DiffGram" TypPolecenia wartości są obsługiwane.Przykładowy pracy zobacz Wykonywanie za pomocą właściwość CommandStream pliki szablonów.

• CommandType
  Określa typ polecenia.Ta właściwość jest używana do określania typu polecenie, które chcesz wykonać.Wartości w tej tabela określają typ polecenia.Przykładowy pracy zobacz Dostęp do funkcjonalności SQLXML w środowisku .NET.

  Wartość	Description
  SqlXmlCommandType.Sql	Wykonuje to polecenie SQL (na przykład SELECT * FROM Employees FOR XML AUTO).
  SqlXmlCommandType.XPath	(Na przykład, wykonuje to polecenie XPath Employees[@EmployeeID=1]).
  SqlXmlCommandType.Template	Wykonuje szablonu XML.
  SqlXmlCommandType.TemplateFile	Wykonuje plik szablonu w określonej ścieżce.
  SqlXmlCommandType.UpdateGram	Wykonuje updategram.
  SqlXmlCommandType.Diffgram	Wykonuje element w formacie DiffGram.

See Also

Reference