SqlPipe.Send Метод

Определение

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

Microsoft.SqlServer.Server

Сборка:

System.Data.dll

Отправляет результаты непосредственно клиенту или текущему получателю выходных данных.

Перегрузки

Send(SqlDataRecord)	Отправляет однострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.
Send(SqlDataReader)	Отправляет многострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.
Send(String)	Отправляет строковое сообщение непосредственно клиенту или текущему получателю выходных данных.

Комментарии

Метод Send пересылает данные напрямую клиенту или вызывающему. Обычно клиент использует выходные данные из метода Pipe , но в случае вложенных хранимых процедур СРЕДЫ CLR потребитель выходных данных также может быть хранимой процедурой. Например, Procedure1 вызывает ExecuteReader с текстом команды "EXEC Procedure2". Procedure2 — это также управляемая хранимая процедура. Если Procedure2 теперь вызывает Send, строка отправляется в средство чтения Procedure1, а не клиенту.

Send(SqlDataRecord)

Отправляет однострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.

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)

Параметры

record

SqlDataRecord

Однострочный результирующий набор, отправляемый клиенту: объект SqlDataRecord.

Исключения

ArgumentNullException

record является null.

Send(SqlDataReader)

Отправляет многострочный результирующий набор непосредственно клиенту или текущему получателю выходных данных.

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)

Параметры

reader

SqlDataReader

Многострочный результирующий набор, отправляемый клиенту: объект SqlDataReader.

Исключения

ArgumentNullException

Значение параметра reader — null.

Комментарии

Если объект, передаваемый SqlDataReader в качестве параметра, содержит скрытые столбцы, эти столбцы не распространяются на результирующий набор, отправляемый клиенту.

Send(String)

Отправляет строковое сообщение непосредственно клиенту или текущему получателю выходных данных.

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

public void Send(string message);

member this.Send : string -> unit

Public Sub Send (message As String)

Параметры

message

String

Строка сообщения, отправляемая клиенту.

Исключения

ArgumentException

Длина сообщения message превышает 4000 символов.

ArgumentNullException

Значение параметра message — null.

Примеры

В следующем примере метод используется для отправки Send строки сообщения непосредственно клиенту.

[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

Комментарии

Строка сообщения отправляется клиенту в качестве информационного сообщения. Клиентские приложения могут прослушивать сообщения с помощью различных механизмов в зависимости от используемого ими api-интерфейса для доступа к данным. Например, если клиент использует ADO.NET, сообщения передаются через InfoMessage событие .