SqlPipe.Send Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Server

Ensamblado:

System.Data.dll

Envía los resultados directamente al cliente o al consumidor actual de los resultados.

Sobrecargas

Send(SqlDataRecord)	Envía un conjunto de resultados de una sola fila directamente al cliente o al consumidor actual de los resultados.
Send(SqlDataReader)	Envía un conjunto de resultados multifila directamente al cliente o al consumidor actual de los resultados.
Send(String)	Envía un mensaje de la cadena directamente al cliente o al consumidor actual de los resultados.

Comentarios

El método Send envía los datos directamente al cliente o autor de la llamada. Normalmente es el cliente que consume la salida del método Pipe , pero en el caso de los procedimientos almacenados CLR anidados, el consumidor de salida también puede ser un procedimiento almacenado. Por ejemplo, Procedure1 llama ExecuteReader a con el texto de comando "EXEC Procedure2". Procedure2 también es un procedimiento almacenado administrado. Si Procedure2 ahora llama Senda , la fila se envía al lector de Procedure1, no al cliente.

Send(SqlDataRecord)

Envía un conjunto de resultados de una sola fila directamente al cliente o al consumidor actual de los resultados.

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)

Parámetros

record

SqlDataRecord

Conjunto de resultados de una sola fila enviado al cliente: un objeto SqlDataRecord.

Excepciones

ArgumentNullException

El valor de record es null.

Send(SqlDataReader)

Envía un conjunto de resultados multifila directamente al cliente o al consumidor actual de los resultados.

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)

Parámetros

reader

SqlDataReader

Conjunto de resultados multifila que se va a enviar al cliente: un objeto SqlDataReader.

Excepciones

ArgumentNullException

El valor de reader es null.

Comentarios

Si el SqlDataReader objeto pasado como parámetro tiene columnas ocultas, esas columnas no se propagan al conjunto de resultados enviado al cliente.

Send(String)

Envía un mensaje de la cadena directamente al cliente o al consumidor actual de los resultados.

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

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Parámetros

message

String

Cadena de mensaje que se va a enviar al cliente.

Excepciones

ArgumentException

message supera los 4.000 caracteres.

ArgumentNullException

El valor de message es null.

Ejemplos

En el ejemplo siguiente se usa el Send método para enviar una cadena de mensaje directamente al cliente.

[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

Comentarios

La cadena de mensaje se envía como un mensaje informativo al cliente. Las aplicaciones cliente pueden escuchar mensajes a través de diferentes mecanismos, en función de la interfaz de programación de aplicaciones (API) de acceso a datos que usen. Por ejemplo, si el cliente usa ADO.NET, los mensajes transmiten a través del InfoMessage evento .