SqlPipe.Send Yöntem

Tanım

Ad Alanı:

Microsoft.SqlServer.Server

Bütünleştirilmiş Kod:

System.Data.dll

Sonuçları doğrudan istemciye veya geçerli çıkış tüketicisine gönderir.

Aşırı Yüklemeler

Send(SqlDataRecord)	Tek satırlı sonuç kümesini doğrudan istemciye veya geçerli çıkış tüketicisine gönderir.
Send(SqlDataReader)	Çoklu bir sonuç kümesini doğrudan istemciye veya geçerli çıkış tüketicisine gönderir.
Send(String)	Doğrudan istemciye veya geçerli çıkış tüketicisine bir dize iletisi gönderir.

Açıklamalar

Send yöntemi verileri doğrudan istemciye veya çağırana gönderir. Genellikle Pipe yönteminden çıkışı kullanan istemcidir, ancak iç içe CLR saklı yordamları söz konusu olduğunda, çıkış tüketicisi de bir saklı yordam olabilir. Örneğin, Yordam1 "EXEC Procedure2" komut metniyle çağırır ExecuteReader . Procedure2 aynı zamanda yönetilen bir saklı yordamdır. Yordam2 şimdi çağrılırsa Send, satır istemciye değil Yordam1'in okuyucusna gönderilir.

Send(SqlDataRecord)

Tek satırlı sonuç kümesini doğrudan istemciye veya geçerli çıkış tüketicisine gönderir.

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)

Parametreler

record

SqlDataRecord

İstemciye gönderilen tek satırlı sonuç kümesi: bir SqlDataRecord nesne.

Özel durumlar

ArgumentNullException

şeklindedir recordnull.

Send(SqlDataReader)

Çoklu bir sonuç kümesini doğrudan istemciye veya geçerli çıkış tüketicisine gönderir.

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)

Parametreler

reader

SqlDataReader

İstemciye gönderilecek çoklu iş sonucu kümesi: bir SqlDataReader nesne.

Özel durumlar

ArgumentNullException

şeklindedir readernull.

Açıklamalar

SqlDataReader Parametre olarak geçirilen nesnenin gizli sütunları varsa, bu sütunlar istemciye gönderilen sonuç kümesine yayılmaz.

Send(String)

Doğrudan istemciye veya geçerli çıkış tüketicisine bir dize iletisi gönderir.

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

public void Send(string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Parametreler

message

String

İstemciye gönderilecek ileti dizesi.

Özel durumlar

ArgumentException

message 4.000 karakterden büyüktür.

ArgumentNullException

şeklindedir messagenull.

Örnekler

Aşağıdaki örnek, doğrudan istemciye bir ileti dizesi göndermek için yöntemini kullanır 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

Açıklamalar

İleti dizesi, istemciye bilgilendirici bir ileti olarak gönderilir. İstemci uygulamaları, kullandıkları veri erişimi uygulama programlama arabirimine (API) bağlı olarak iletileri farklı mekanizmalar aracılığıyla dinleyebilir. Örneğin, istemci ADO.NET kullanıyorsa, iletiler olay üzerinden iletilir InfoMessage .