SqlPipe.Send Metoda

Definice

Obor názvů:

Microsoft.SqlServer.Server

Sestavení:

System.Data.dll

Odesílá výsledky přímo klientovi nebo aktuálnímu příjemci výstupu.

Přetížení

Send(SqlDataRecord)	Odešle sadu výsledků s jedním řádkem přímo klientovi nebo aktuálnímu příjemci výstupu.
Send(SqlDataReader)	Odešle vícenásobnou sadu výsledků přímo klientovi nebo aktuálnímu příjemci výstupu.
Send(String)	Odešle řetězcovou zprávu přímo klientovi nebo aktuálnímu příjemci výstupu.

Poznámky

Metoda Send odesílá data přímo klientovi nebo volajícímu. Obvykle je to klient, který využívá výstup z metody Pipe , ale v případě vnořených uložených procedur CLR může být výstupním příjemcem také uložená procedura. Například Procedura1 volá ExecuteReader s textem příkazu "EXEC Procedure2". Procedura2 je také spravovaná uložená procedura. Pokud procedura2 nyní volá Send, je řádek odeslán čtenáři Procedury1, ne klientovi.

Send(SqlDataRecord)

Odešle sadu výsledků s jedním řádkem přímo klientovi nebo aktuálnímu příjemci výstupu.

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)

Parametry

record

SqlDataRecord

Sada výsledků s jedním řádkem odeslaná SqlDataRecord klientovi: objekt.

Výjimky

ArgumentNullException

Hodnota record je null.

Send(SqlDataReader)

Odešle vícenásobnou sadu výsledků přímo klientovi nebo aktuálnímu příjemci výstupu.

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)

Parametry

reader

SqlDataReader

Vícenásobná sada výsledků, která se má odeslat klientovi: SqlDataReader objekt.

Výjimky

ArgumentNullException

Hodnota reader je null.

Poznámky

SqlDataReader Pokud má objekt předaný jako parametr skryté sloupce, nebudou tyto sloupce šířené do sady výsledků odeslané klientovi.

Send(String)

Odešle řetězcovou zprávu přímo klientovi nebo aktuálnímu příjemci výstupu.

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

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Parametry

message

String

Řetězec zprávy, který se má odeslat klientovi.

Výjimky

ArgumentException

Hodnota message je větší než 4 000 znaků.

ArgumentNullException

Hodnota message je null.

Příklady

Následující příklad používá metodu Send k odeslání řetězce zprávy přímo klientovi.

[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

Poznámky

Řetězec zprávy se klientovi odešle jako informační zpráva. Klientské aplikace můžou poslouchat zprávy prostřednictvím různých mechanismů v závislosti na aplikačním programovacím rozhraní (API) pro přístup k datům, které používají. Pokud například klient používá ADO.NET, zprávy se přenášejí prostřednictvím InfoMessage události.