SqlPipe Clase

Referencia

Definición

Espacio de nombres:: Microsoft.SqlServer.Server

Ensamblado:: System.Data.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Permite a los procedimientos almacenados administrados que se ejecutan en un proceso de una base de datos de SQL Server devolver los resultados al llamador. Esta clase no puede heredarse.

public ref class SqlPipe sealed

public sealed class SqlPipe

type SqlPipe = class

Public NotInheritable Class SqlPipe

Herencia: Object
SqlPipe

Ejemplos

En el ejemplo siguiente se usa SqlConnection y SqlCommand para seleccionar filas de un origen de datos en un procedimiento almacenado. A continuación, en el ejemplo se usa para SqlPipe ejecutar el comando y devolver los resultados al cliente.

[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

Comentarios

Una instancia de esta clase está disponible para los procedimientos almacenados administrados a través de la Pipe propiedad de la SqlContext clase .

Propiedades

IsSendingResults

Obtiene un valor que indica si SqlPipe está en el modo de devolver al cliente los conjuntos de resultados únicos. Esta propiedad es de sólo lectura.

Métodos

ExecuteAndSend(SqlCommand)	Ejecuta el comando pasado como parámetro y envía los resultados al cliente.
Send(SqlDataReader)	Envía un conjunto de resultados multifila directamente al cliente o al consumidor actual de los resultados.
Send(SqlDataRecord)	Envía un conjunto de resultados de una sola fila directamente al cliente o al consumidor actual de los resultados.
Send(String)	Envía un mensaje de la cadena directamente al cliente o al consumidor actual de los resultados.
SendResultsEnd()	Marca el fin de un conjunto de resultados y devuelve la instancia de SqlPipe al estado inicial.
SendResultsRow(SqlDataRecord)	Devuelve al cliente una fila de datos única.
SendResultsStart(SqlDataRecord)	Marca el inicio de un conjunto de resultados que se va a devolver al cliente y utiliza el parámetro de registro para generar los metadatos que describen el conjunto de resultados.

Se aplica a