SqlPipe.ExecuteAndSend メソッド

.NET Framework クラス ライブラリ リファレンス

SqlPipe.ExecuteAndSend メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

パラメータとして渡されたコマンドを実行し、結果をクライアントに返します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub ExecuteAndSend ( _
    command As SqlCommand _
)

Visual Basic (使用法)

Dim instance As SqlPipe
Dim command As SqlCommand

instance.ExecuteAndSend(command)

C#

public void ExecuteAndSend (
    SqlCommand command
)

C++

public:
void ExecuteAndSend (
    SqlCommand^ command
)

J#

public void ExecuteAndSend (
    SqlCommand command
)

JScript

public function ExecuteAndSend (
    command : SqlCommand
)

パラメータ

command

実行対象の SqlCommand オブジェクト。

例外

例外の種類	条件
ArgumentNullException	command が null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	アウトプロセス接続にバインドされたコマンドに対してこのメソッドを使用することはできません。

解説

実際の結果の他に、その他のメッセージおよびエラーも直接クライアントに送信されます。

出力パラメータと戻り値はクライアントに送信されません。ただし、呼び出し元から、コマンド オブジェクトのパラメータ コレクションを通じて出力パラメータと戻り値にアクセスできます。

コマンドがインプロセス接続にバインドされていない場合、InvalidOperationException がスローされます。アウトプロセス接続にバインドされたコマンドに対してこのメソッドを使用することはできません。

使用例

次の例では、まず、ストアド プロシージャで、SqlConnection および SqlCommand を使用し、データ ソースから行を選択します。次に、SqlPipe を使用してコマンドを実行し、結果をクライアントに返しています。

Visual Basic

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub StoredProcExecuteCommand(ByVal
 rating As Integer)
    Dim command As SqlCommand

    ' Connect through the context connection
    Using connection As New SqlConnection("context
 connection=true")
        connection.Open()

        command = New SqlCommand( _
            "SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor
 " & _
            "WHERE CreditRating <= @rating", connection)
        command.Parameters.AddWithValue("@rating",
 rating)

        ' Execute the command and send the results directly to the client
        SqlContext.Pipe.ExecuteAndSend(command)
    End Using
End Sub

C#

[Microsoft.SqlServer.Server.SqlProcedure()]
public static void StoredProcExecuteCommand(int
 rating)
{
    // Connect through the context connection.
    using (SqlConnection connection = new SqlConnection("context
 connection=true"))
    {
        connection.Open();

        SqlCommand command = new SqlCommand(
            "SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor "
 +
            "WHERE CreditRating <= @rating", connection);
        command.Parameters.AddWithValue("@rating", rating);

        // Execute the command and send the results directly to the
 client.
        SqlContext.Pipe.ExecuteAndSend(command);
        
    }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlPipe クラス
SqlPipe メンバ
Microsoft.SqlServer.Server 名前空間