SqlPipe Třída

Definice

Umožňuje, aby spravované uložené procedury spuštěné v procesu v databázi SQL Server vracely výsledky zpět volajícímu. Tato třída se nemůže dědit.

public ref class SqlPipe sealed
public sealed class SqlPipe
type SqlPipe = class
Public NotInheritable Class SqlPipe
Dědičnost
SqlPipe

Příklady

Následující příklad používá SqlConnection a SqlCommand k výběru řádků ze zdroje dat v uložené proceduře. Příklad pak použije SqlPipe příkaz ke spuštění příkazu a odeslání výsledků zpět klientovi.

[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

Poznámky

Instance této třídy je zpřístupněna spravovaným uloženým procedurami prostřednictvím Pipe vlastnosti SqlContext třídy .

Vlastnosti

IsSendingResults

Získá hodnotu, která označuje, zda SqlPipe je v režimu odesílání jedné sady výsledků zpět do klienta. Tato vlastnost je jen ke čtení.

Metody

ExecuteAndSend(SqlCommand)

Spustí příkaz předaný jako parametr a odešle výsledky klientovi.

Send(SqlDataReader)

Odešle vícenásobnou sadu výsledků dotazu přímo klientovi nebo aktuálnímu příjemci výstupu.

Send(SqlDataRecord)

Odešle sadu výsledků s jedním řádkem přímo klientovi nebo aktuálnímu příjemci výstupu.

Send(String)

Odešle řetězcovou zprávu přímo klientovi nebo aktuálnímu příjemci výstupu.

SendResultsEnd()

Označí konec sady výsledků dotazu a vrátí SqlPipe instanci zpět do počátečního stavu.

SendResultsRow(SqlDataRecord)

Odešle jeden řádek dat zpět klientovi.

SendResultsStart(SqlDataRecord)

Označí začátek sady výsledků dotazu, která má být odeslána zpět klientovi, a pomocí parametru záznamu vytvoří metadata, která popisují sadu výsledků.

Platí pro