SqlPipe.Send Metodo

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Invia i risultati direttamente al client o al consumer dell'output corrente.

Overload

Send(SqlDataRecord)	Invia un gruppo di risultati a riga singola direttamente al client o al consumer dell'output corrente.
Send(SqlDataReader)	Invia un gruppo di risultati a riga multipla direttamente al client o al consumer dell'output corrente.
Send(String)	Invia un messaggio stringa direttamente al client o al consumer dell'output corrente.

Commenti

Il metodo Send invia i dati direttamente al client o al chiamante. È in genere il client che utilizza l'output dal metodo Pipe , ma nel caso di stored procedure CLR annidate, il consumer di output può anche essere una stored procedure. Ad esempio, Procedure1 chiama ExecuteReader con il testo del comando "EXEC Procedure2". Procedure2 è anche una stored procedure gestita. Se procedure2 chiama Sendora , la riga viene inviata al lettore di Procedure1, non al client.

Send(SqlDataRecord)

Invia un gruppo di risultati a riga singola direttamente al client o al consumer dell'output corrente.

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)

Parametri

record

SqlDataRecord

Gruppo di risultati a riga singola inviato al client: oggetto SqlDataRecord.

Eccezioni

ArgumentNullException

L'elemento record è null.

Send(SqlDataReader)

Invia un gruppo di risultati a riga multipla direttamente al client o al consumer dell'output corrente.

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)

Parametri

reader

SqlDataReader

Il set di risultati a riga multipla da inviare al client: oggetto SqlDataReader.

Eccezioni

ArgumentNullException

L'elemento reader è null.

Commenti

Se l'oggetto SqlDataReader passato come parametro ha colonne nascoste, tali colonne non vengono propagate al set di risultati inviato al client.

Send(String)

Invia un messaggio stringa direttamente al client o al consumer dell'output corrente.

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

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Parametri

message

String

Stringa di messaggio da inviare al client.

Eccezioni

ArgumentException

L'oggetto message è composto da più di 4.000 caratteri.

ArgumentNullException

L'elemento message è null.

Esempio

Nell'esempio seguente viene usato il Send metodo per inviare una stringa di messaggio direttamente al client.

[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

Commenti

La stringa di messaggio viene inviata come messaggio informativo al client. Le applicazioni client possono ascoltare i messaggi tramite meccanismi diversi, a seconda dell'interfaccia di programmazione dell'applicazione di accesso ai dati (API) usata. Ad esempio, se il client usa ADO.NET, i messaggi vengono trasmessi tramite l'evento InfoMessage .