Obiekt SqlXmlCommand (SQLXML zarządzane klasy)

Metody

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

• void ExecuteNonQuery()
  Wykonuje polecenie, ale nie zwraca żadnych informacji.Ta metoda jest użyteczna, jeśli chcesz wykonać polecenia nonquery (oznacza to, że polecenie nie zwraca żadnych informacji).Przykładem jest wykonywana wierzchołki lub w formacie DiffGram, który aktualizuje rekordy, ale nic nie zwraca.

• Stream ExecuteStream()
  Zwraca nowy Stream obiektu.Ta metoda jest użyteczna, jeśli chcesz, aby wyniki kwerendy, zwracane w nowego strumienia.Dla próbki pracy, zobacz Wykonywanie kwerend SQL (SQLXML zarządzane klasy).

• public void ExecuteToStream(Stream outputStream)
  Zapisuje wyniki kwerendy istniejącego strumienia.Ta metoda jest przydatna, gdy strumień, do której należy wyniki dołączane (na przykład, aby kwerenda wyniki zapisane System.Web.HttpResponse.OutputStream).Dla próbki pracy, zobacz Wykonywanie kwerend SQL (SQLXML zarządzane klasy).

• XmlReader ExecuteXmlReader()
  Zwraca XmlReader obiektu.Ta metoda służy do manipulowania albo danych w XmlReader bezpośrednio do obiektu lub plug architektury chainable System.Xml.Aby uzyskać więcej informacji, zobacz Microsoft .NET Framework dokumentacji.Dla próbki pracy, zobacz Wykonywanie kwerend SQL za pomocą metody elementu ExecuteXMLReader.

TheSqlXmlCommand object also supports these additional methods:

• SqlXmlParameter CreateParameter()
  Tworzy SqlXmlParameter obiektu.zestaw wartości dla Name i Value Parametry obiektu.Ta metoda jest użyteczna, jeśli chcesz przekazać parametry polecenia.Dla próbki pracy, zobacz Wykonywanie kwerend SQL (SQLXML zarządzane klasy).

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

Właściwości

SqlXmlCommand Obiekt obsługuje również te właściwości:

• ClientSideXml
  Gdy opcja prawda, określa, że konwersja zestawu zestaw wierszy do pliku XML występują klient, a nie na serwerze.Ta właściwość jest przydatna, gdy chcesz przenieść obciążenia wydajności w warstwie środkowej.Właściwość umożliwia również Zawijaj istniejących procedur przechowywanych na XML, aby uzyskać dane wyjściowe XML.

• SchemaPath
  Nazwa schematu mapowania razem z katalogu ścieżka (na przykład C:\x\y\MySchema.xml).Ta właściwość jest przydatna do określania mapowania schematu dla kwerend XPath.ścieżka określonej może być bezwzględna lub względna.Jeśli ścieżka jest względna, ścieżki bazowej określonej w Base Path jest używany do rozpoznawania względną ścieżkąJeżeli nie określono żadnych ścieżki bazowej, ścieżka względna jest względem bieżącego katalogu.Dla próbki pracy, zobacz Dostęp do funkcji SQLXML.Środowisko netto.

• XslPath
  Nazwa pliku XSL, razem z katalogu ścieżka.ścieżka określonej może być bezwzględna lub względna.Jeśli ścieżka jest względna, ścieżki bazowej określonej w Base Path jest używany do rozpoznawania względną ścieżkąJeżeli nie określono żadnych ścieżki bazowej, ścieżka względna jest względem bieżącego katalogu.Dla próbki pracy, zobacz Stosowanie XSL Transformation (SQLXML zarządzane klasy).

• Base Path
  ścieżka bazowej (ścieżka katalogu).Ta właściwość jest przydatna podczas rozwiązywania Krewny ścieżka określonego dla pliku XSL (za pomocą XslPath Właściwości), plik schematu mapowania (za pomocą SchemaPath Właściwości), lub odwołaniem zewnętrznym schematu XML szablonu (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 dla żądających określonego kodowania dla strumienia, który jest zwracany.Niektóre powszechnie używane kodowań są UTF-8, ANSI i Unicode.UTF-8 jest domyślne kodowanie.

• Namespaces
  Umożliwia wykonanie kwerendy XPath, używające obszarów nazw.Aby uzyskać więcej informacji o kwerendach XPath z obszarami nazw, zobacz Wykonywanie kwerend XPath z przestrzeniami nazw (SQLXML zarządzane klasy).Dla próbki pracy, zobacz Wykonywanie kwerend XPath (SQLXML zarządzane klasy).

• RootTag
  Zapewnia głównego pojedynczego elementu XML generowane przez wykonanie polecenia.Prawidłowy dokument XML wymaga pojedynczego znacznika głównego poziom.Polecenie wykonane generuje fragment XML (bez jeden element najwyższego poziom) można określić elementu głównego, przekazujące dane XML.Dla próbki pracy, zobacz Stosowanie XSL Transformation (SQLXML zarządzane klasy).

• CommandText
  Tekst polecenia.Ta właściwość jest używana do określania tekstu polecenia chcesz wykonać.Dla próbki pracy, zobacz Wykonywanie kwerend SQL (SQLXML zarządzane klasy).

• CommandStream
  Strumień polecenia.Ta właściwość jest przydatna do wykonać polecenia z pliku (na przykład szablon XML).Kiedy używasz CommandStream, tylko "Szablon", "Wierzchołki" i "W formacie DiffGram" elementu CommandType wartości są obsługiwane.Dla próbki pracy, zobacz Pliki szablonów nakaz za pomocą właściwości CommandStream.

• CommandType
  Identyfikuje typ polecenia.Ta właściwość jest używana do określania typu polecenia chcesz wykonać.Wartości w następującej tabela określają typ polecenia.Dla próbki pracy, zobacz Dostęp do funkcji SQLXML.Środowisko netto.

  Wartość	Opis
  SqlXmlCommandType.Sql	Wykonuje polecenia SQL (na przykład SELECT * FROM Employees FOR XML AUTO).
  SqlXmlCommandType.XPath	Wykonuje polecenia XPath (na przykład Employees[@BusinessEntityID=1]).
  SqlXmlCommandType.Template	Wykonuje szablon XML.
  SqlXmlCommandType.TemplateFile	Wykonuje plik szablonu w określonym ścieżka.
  SqlXmlCommandType.UpdateGram	Wykonuje wierzchołki.
  SqlXmlCommandType.Diffgram	Wykonuje w formacie DiffGram.

Zobacz także

Odwołanie