SqlPipe.Send Método

Definição

Namespace:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Envia os resultados diretamente ao cliente ou ao consumidor de saída atual.

Sobrecargas

Send(SqlDataRecord)	Envia um conjunto de resultados de linha única diretamente ao cliente ou ao consumidor de saída atual.
Send(SqlDataReader)	Envia um conjunto de resultados multilinha diretamente para o cliente ou para o consumidor de saída.
Send(String)	Envia uma mensagem de cadeia de caracteres diretamente ao cliente ou ao consumidor de saída atual.

Comentários

O método Send envia dados diretamente ao cliente ou chamador. Geralmente, é o cliente que consome a saída do método Pipe , mas no caso de procedimentos armazenados CLR aninhados, o consumidor de saída também pode ser um procedimento armazenado. Por exemplo, Procedure1 chama ExecuteReader com o texto de comando "EXEC Procedure2". Procedure2 também é um procedimento armazenado gerenciado. Se Procedure2 agora chamar Send, a linha será enviada para o leitor do Procedure1, não para o cliente.

Send(SqlDataRecord)

Envia um conjunto de resultados de linha única diretamente ao cliente ou ao consumidor de saída atual.

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

O conjunto de resultados de linha única enviado ao cliente: um objeto SqlDataRecord.

Exceções

ArgumentNullException

O record é null.

Send(SqlDataReader)

Envia um conjunto de resultados multilinha diretamente para o cliente ou para o consumidor de saída.

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

O conjunto de resultados multilinha a ser enviado ao cliente: um objeto SqlDataReader.

Exceções

ArgumentNullException

O reader é null.

Comentários

Se o SqlDataReader objeto passado como um parâmetro tiver colunas ocultas, essas colunas não serão propagadas para o conjunto de resultados enviado ao cliente.

Send(String)

Envia uma mensagem de cadeia de caracteres diretamente ao cliente ou ao consumidor de saída atual.

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

A cadeia de caracteres de mensagem a ser enviada ao cliente.

Exceções

ArgumentException

A message tem mais de 4.000 caracteres.

ArgumentNullException

O message é null.

Exemplos

O exemplo a seguir usa o Send método para enviar uma cadeia de caracteres de mensagem diretamente para o 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

Comentários

A cadeia de caracteres de mensagem é enviada como uma mensagem informativa para o cliente. Os aplicativos cliente podem escutar mensagens por meio de mecanismos diferentes, dependendo da API (interface de programação de aplicativo) de acesso a dados que eles usam. Por exemplo, se o cliente estiver usando ADO.NET, as mensagens transmitirão por meio do InfoMessage evento.