SqlPipe Класс

Определение

Пространство имен:

Microsoft.SqlServer.Server

Сборка:

System.Data.dll

Разрешает управляемым хранимым процедурам, выполняемым внутри процесса в базе данных SQL Server, возвращать результаты в вызывающую программу. Этот класс не наследуется.

public ref class SqlPipe sealed

public sealed class SqlPipe

type SqlPipe = class

Public NotInheritable Class SqlPipe

Наследование

Object

SqlPipe

Примеры

В следующем примере используется SqlConnection и SqlCommand для выбора строк из источника данных в хранимой процедуре. Затем в примере используется SqlPipe для выполнения команды и отправки результатов обратно клиенту.

[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

Комментарии

Экземпляр этого класса становится доступным для управляемых хранимых процедур с помощью Pipe свойства SqlContext класса .

Свойства

IsSendingResults

Получает значение, показывающее, находится ли объект SqlPipe в режиме отправки одиночных результирующих наборов клиенту. Это свойство доступно только для чтения.

Методы

ExecuteAndSend(SqlCommand)	Выполняет команду, переданную в качестве параметра, и отправляет результаты клиенту.
Send(SqlDataReader)	Отправляет многострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.
Send(SqlDataRecord)	Отправляет однострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.
Send(String)	Отправляет строковое сообщение непосредственно клиенту или текущему получателю выходных данных.
SendResultsEnd()	Помечает окончание результирующего набора и возвращает экземпляр SqlPipe в начальное состояние.
SendResultsRow(SqlDataRecord)	Отправляет клиенту одну строку данных.
SendResultsStart(SqlDataRecord)	Помечает начало результирующего набора, отправляемого клиенту, и использует указанную запись для конструирования метаданных, описывающих результирующий набор.