6.2.5.11 ExecuteToStream

このメソッドでは、XmlCommandTypeプロパティとCommandTextプロパティを使用してコマンドを実行し、結果をアプリケーションによって指定された既存のStreamにXML文書として追加します。

宣言

// C#
public void ExecuteToStream(Stream outputStream);

パラメータ

  • outputStream

    Stream

備考

ExecuteToStreamの動作はXmlCommandTypeプロパティ値によって異なります。

  • XmlCommandType = OracleXmlCommandType.None

    ExecuteToStreamでは、InvalidOperationExceptionをスローします。

  • XmlCommandType = OracleXmlCommandType.Query

    ExecuteToStreamでは、CommandTextプロパティの選択文を実行し、成功した場合は指定したStreamに生成されたXML文書を追加します。

    SQL問合せによって行が戻されない場合は、指定されたStreamには何も追加されません。追加されたデータのキャラクタ・セットはUnicodeです。

  • XmlCommandType = OracleXmlCommandType.InsertOracleXmlCommandType.UpdateまたはOracleXmlCommandType.Delete

    CommandTextプロパティの値はXML文書です。ExecuteToStreamでは、そのXML文書の変更をXmlSavePropertiesプロパティで指定されている表またはビューに保存します。指定されたStreamには何も追加されません。