SqlPipe.Send Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Envoie les résultats directement au client ou au consommateur de sortie actuel.

Surcharges

Send(SqlDataRecord)	Envoie un jeu de résultats à une seule ligne directement au client ou au consommateur de sortie actuel.
Send(SqlDataReader)	Envoie un jeu de résultats multiligne directement au client ou au consommateur de sortie actuel.
Send(String)	Envoie un message de type chaîne directement au client ou au consommateur de sortie actuel.

Remarques

La méthode Send envoie des données directement au client ou à l'appelant. C’est généralement le client qui consomme la sortie de la méthode Pipe , mais dans le cas de procédures stockées CLR imbriquées, le consommateur de sortie peut également être une procédure stockée. Par exemple, Procedure1 appelle ExecuteReader avec le texte de commande « EXEC Procedure2 ». Procedure2 est également une procédure stockée managée. Si Procedure2 appelle Sendmaintenant , la ligne est envoyée au lecteur de Procedure1, et non au client.

Send(SqlDataRecord)

Envoie un jeu de résultats à une seule ligne directement au client ou au consommateur de sortie actuel.

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)

Paramètres

record

SqlDataRecord

Jeu de résultats à une seule ligne envoyé au client : un objet SqlDataRecord.

Exceptions

ArgumentNullException

Le record est null.

Send(SqlDataReader)

Envoie un jeu de résultats multiligne directement au client ou au consommateur de sortie actuel.

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)

Paramètres

reader

SqlDataReader

Jeu de résultats multiligne à envoyer au client : un objet SqlDataReader.

Exceptions

ArgumentNullException

reader a la valeur null.

Remarques

Si l’objet SqlDataReader transmis en tant que paramètre a des colonnes masquées, ces colonnes ne sont pas propagées vers le jeu de résultats envoyé au client.

Send(String)

Envoie un message de type chaîne directement au client ou au consommateur de sortie actuel.

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

public void Send (string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Paramètres

message

String

Chaîne de message à envoyer au client.

Exceptions

ArgumentException

Le message comporte plus de 4 000 caractères.

ArgumentNullException

message a la valeur null.

Exemples

L’exemple suivant utilise la Send méthode pour envoyer une chaîne de message directement au 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

Remarques

La chaîne de message est envoyée sous forme de message d’information au client. Les applications clientes peuvent écouter les messages via différents mécanismes, en fonction de l’interface de programmation d’application (API) d’accès aux données qu’elles utilisent. Par exemple, si le client utilise ADO.NET, les messages sont transmis via l’événement InfoMessage .