SqlPipe.Send Metodo

  • Riferimento

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.

Si applica a

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.

Si applica a

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 .

Si applica a