SqlPipe.Send 方法

定義

命名空間:

Microsoft.SqlServer.Server

組件:

System.Data.dll

將結果直接傳送至用戶端或目前的輸出消費者。

多載

Send(SqlDataRecord)	將單一資料列結果集直接傳送至用戶端或目前的輸出消費者。
Send(SqlDataReader)	將多資料列結果集直接傳送至用戶端或目前的輸出消費者。
Send(String)	將字串訊息直接傳送至用戶端或目前的輸出消費者。

備註

Send方法會將資料直接傳送至用戶端或呼叫端。 它通常是取用 Pipe 方法輸出的用戶端，但在巢狀 CLR 預存程式中，輸出取用者也可以是預存程式。 例如，Procedure1 會使用命令文字 「EXEC Procedure2」 呼叫 ExecuteReader 。 而 Procedure2 也是 Managed 預存程序。 如果 Procedure2 現在呼叫 Send ，則資料列會傳送至 Procedure1 的讀取器，而不是傳送至用戶端。

Send(SqlDataRecord)

將單一資料列結果集直接傳送至用戶端或目前的輸出消費者。

public:
 void Send(Microsoft::SqlServer::Server::SqlDataRecord ^ record);

public void Send (Microsoft.SqlServer.Server.SqlDataRecord record);

member this.Send : Microsoft.SqlServer.Server.SqlDataRecord -> unit

Public Sub Send (record As SqlDataRecord)

參數

record

SqlDataRecord

要傳送至用戶端的單一資料列結果集：SqlDataRecord 物件。

例外狀況

ArgumentNullException

record 為 null。

Send(SqlDataReader)

將多資料列結果集直接傳送至用戶端或目前的輸出消費者。

public:
 void Send(System::Data::SqlClient::SqlDataReader ^ reader);

public void Send (System.Data.SqlClient.SqlDataReader reader);

member this.Send : System.Data.SqlClient.SqlDataReader -> unit

Public Sub Send (reader As SqlDataReader)

參數

reader

SqlDataReader

要傳送至用戶端的多資料列結果集：SqlDataReader 物件。

例外狀況

ArgumentNullException

reader 為 null。

備註

SqlDataReader如果以參數的形式傳入的物件具有隱藏的資料行，這些資料行就不會傳播到傳送給用戶端的結果集。

Send(String)

將字串訊息直接傳送至用戶端或目前的輸出消費者。

public:
 void Send(System::String ^ message);

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

參數

message

String

要傳送至用戶端的訊息字串。

例外狀況

ArgumentException

message 超過 4,000 個字元。

ArgumentNullException

message 為 null。

範例

下列範例會使用 方法， Send 直接將訊息字串傳送至用戶端。

[Microsoft.SqlServer.Server.SqlProcedure]
public static void StoredProcSendMessage()
{
    // Send a message string back to the client.
    SqlContext.Pipe.Send("Hello World!");
}

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub StoredProcSendMessage()

    ' Send a message string back to the client.
    SqlContext.Pipe.Send("Hello world!")

End Sub

備註

訊息字串會以參考訊息的形式傳送至用戶端。 用戶端應用程式可以透過不同的機制接聽訊息，視其所使用的資料存取應用程式開發介面 (API) 而定。 例如，如果用戶端使用 ADO.NET，訊息會透過 InfoMessage 事件傳輸。