SqlPipe.Send Metoda

Definicja

Przestrzeń nazw:

Microsoft.SqlServer.Server

Zestaw:

System.Data.dll

Wysyła wyniki bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.

Przeciążenia

Send(SqlDataRecord)	Wysyła zestaw wyników z jednym wierszem bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.
Send(SqlDataReader)	Wysyła zestaw wyników wielorowowych bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.
Send(String)	Wysyła komunikat ciągu bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.

Uwagi

Metoda Send wysyła dane bezpośrednio do klienta lub wywołującego. Zazwyczaj klient zużywa dane wyjściowe z metody Pipe , ale w przypadku zagnieżdżonych procedur składowanych CLR odbiorca danych wyjściowych może być również procedurą składowaną. Na przykład wywołania ExecuteReader Procedure1 z tekstem polecenia "EXEC Procedure2". Procedura2 jest również zarządzaną procedurą składowaną. Jeśli procedura2 wywołuje Sendteraz metodę , wiersz jest wysyłany do czytnika procedury Procedure1, a nie do klienta.

Send(SqlDataRecord)

Wysyła zestaw wyników z jednym wierszem bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.

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

Zestaw wyników z jednym wierszem wysłany do klienta: SqlDataRecord obiekt.

Wyjątki

ArgumentNullException

Element record to null.

Send(SqlDataReader)

Wysyła zestaw wyników wielorowowych bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.

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

Wielorowowy zestaw wyników, który ma zostać wysłany do klienta: SqlDataReader obiekt.

Wyjątki

ArgumentNullException

Element reader to null.

Uwagi

SqlDataReader Jeśli obiekt przekazany jako parametr ma ukryte kolumny, te kolumny nie są propagowane do zestawu wyników wysyłanego do klienta.

Send(String)

Wysyła komunikat ciągu bezpośrednio do klienta lub bieżącego odbiorcy wyjściowego.

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

Ciąg komunikatu, który ma zostać wysłany do klienta.

Wyjątki

ArgumentException

Wartość message jest większa niż 4000 znaków.

ArgumentNullException

Element message to null.

Przykłady

W poniższym przykładzie użyto Send metody , aby wysłać ciąg komunikatu bezpośrednio do klienta.

[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

Uwagi

Ciąg komunikatu jest wysyłany jako komunikat informacyjny do klienta. Aplikacje klienckie mogą nasłuchiwać komunikatów za pomocą różnych mechanizmów, w zależności od używanego interfejsu programowania aplikacji (API) dostępu do danych. Jeśli na przykład klient korzysta z ADO.NET, komunikaty są przesyłane przez InfoMessage zdarzenie.