SqlPipe Classe

Définition

Espace de noms:

Microsoft.SqlServer.Server

Assembly:

System.Data.dll

Permet aux procédures stockées managées s'exécutant intra processus sur une base de données SQL Server de retourner des résultats à l'appelant. Cette classe ne peut pas être héritée.

public ref class SqlPipe sealed

public sealed class SqlPipe

type SqlPipe = class

Public NotInheritable Class SqlPipe

Héritage

Object

SqlPipe

Exemples

L’exemple suivant utilise SqlConnection et SqlCommand sélectionne des lignes à partir d’une source de données dans une procédure stockée. L’exemple utilise ensuite une SqlPipe commande pour exécuter la commande et renvoyer les résultats au client.

[Microsoft.SqlServer.Server.SqlProcedure()]
public static void StoredProcExecuteCommand(int rating)
{
    // Connect through the context connection.
    using (SqlConnection connection = new SqlConnection("context connection=true"))
    {
        connection.Open();

        SqlCommand command = new SqlCommand(
            "SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor " +
            "WHERE CreditRating <= @rating", connection);
        command.Parameters.AddWithValue("@rating", rating);

        // Execute the command and send the results directly to the client.
        SqlContext.Pipe.ExecuteAndSend(command);
    }
}

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub StoredProcExecuteCommand(ByVal rating As Integer)
    Dim command As SqlCommand

    ' Connect through the context connection
    Using connection As New SqlConnection("context connection=true")
        connection.Open()

        command = New SqlCommand( _
            "SELECT VendorID, AccountNumber, Name FROM Purchasing.Vendor " & _
            "WHERE CreditRating <= @rating", connection)
        command.Parameters.AddWithValue("@rating", rating)

        ' Execute the command and send the results directly to the client
        SqlContext.Pipe.ExecuteAndSend(command)
    End Using
End Sub

Remarques

Une instance de cette classe est mise à la disposition des procédures stockées gérées par le biais de la Pipe propriété de la SqlContext classe.

Propriétés

IsSendingResults

Obtient une valeur qui indique si SqlPipe est en mode d'envoi de jeux de résultats uniques au client. Cette propriété est en lecture seule.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExecuteAndSend(SqlCommand)	Exécute la commande passée en tant que paramètre et envoie les résultats au client.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Send(SqlDataReader)	Envoie un jeu de résultats multiligne directement au client ou au consommateur de sortie actuel.
Send(SqlDataRecord)	Envoie un jeu de résultats à une seule ligne 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.
SendResultsEnd()	Marque la fin d'un jeu de résultats et retourne l'instance de SqlPipe à son état initial.
SendResultsRow(SqlDataRecord)	Renvoie une ligne unique de données au client.
SendResultsStart(SqlDataRecord)	Marque le début d'un jeu de résultats à renvoyer au client et utilise le paramètre d'enregistrement pour construire les métadonnées qui décrivent le jeu de résultats.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)