SqlPipe.Send Metode

Definisi

Ruang nama:

Microsoft.SqlServer.Server

Rakitan:

System.Data.dll

Mengirim hasil langsung ke klien atau konsumen output saat ini.

Overload

Send(SqlDataRecord)	Mengirim hasil baris tunggal yang diatur langsung ke klien atau konsumen output saat ini.
Send(SqlDataReader)	Mengirim hasil multirow yang diatur langsung ke klien atau konsumen output saat ini.
Send(String)	Mengirim pesan string langsung ke klien atau konsumen output saat ini.

Keterangan

Metode Kirim mengirimkan data langsung ke klien atau pemanggil. Biasanya klien yang menggunakan output dari metode Pipa , tetapi dalam kasus prosedur tersimpan CLR berlapis, konsumen output juga dapat menjadi prosedur tersimpan. Misalnya, Prosedur1 memanggil ExecuteReader dengan teks perintah "EXEC Procedure2". Prosedur2 juga merupakan prosedur tersimpan terkelola. Jika Prosedur2 sekarang memanggil Send, baris dikirim ke pembaca Prosedur1, bukan ke klien.

Send(SqlDataRecord)

Mengirim hasil baris tunggal yang diatur langsung ke klien atau konsumen output saat ini.

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)

Parameter

record

SqlDataRecord

Tataan hasil baris tunggal yang dikirim ke klien: SqlDataRecord objek.

Pengecualian

ArgumentNullException

record adalah null.

Send(SqlDataReader)

Mengirim hasil multirow yang diatur langsung ke klien atau konsumen output saat ini.

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)

Parameter

reader

SqlDataReader

Hasil multirow diatur untuk dikirim ke klien: SqlDataReader objek .

Pengecualian

ArgumentNullException

reader adalah null.

Keterangan

Jika objek yang SqlDataReader diteruskan sebagai parameter memiliki kolom tersembunyi, kolom tersebut tidak disebarluaskan ke tataan hasil yang dikirim ke klien.

Send(String)

Mengirim pesan string langsung ke klien atau konsumen output saat ini.

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

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Parameter

message

String

String pesan yang akan dikirim ke klien.

Pengecualian

ArgumentException

lebih message besar dari 4.000 karakter.

ArgumentNullException

message adalah null.

Contoh

Contoh berikut menggunakan Send metode untuk mengirim string pesan langsung ke klien.

[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

Keterangan

String pesan dikirim sebagai pesan informasi ke klien. Aplikasi klien dapat mendengarkan pesan melalui mekanisme yang berbeda, tergantung pada antarmuka pemrograman aplikasi akses data (API) yang mereka gunakan. Misalnya, jika klien menggunakan ADO.NET, pesan dikirimkan InfoMessage melalui peristiwa.