SqlPipe.Send 메서드

정의

네임스페이스:

Microsoft.SqlServer.Server

어셈블리:

System.Data.dll

클라이언트 또는 현재 출력 소비자에게 직접 결과를 보냅니다.

오버로드

Send(SqlDataRecord)	클라이언트나 현재 출력 소비자에게 직접 단일 행 결과 집합을 보냅니다.
Send(SqlDataReader)	클라이언트나 현재 출력 소비자에게 직접 다중 행 결과 집합을 보냅니다.
Send(String)	클라이언트 또는 현재 출력 소비자에게 직접 문자열 메시지를 보냅니다.

설명

Send 메서드는 클라이언트 또는 호출자에게 직접 데이터를 보냅니다. 일반적으로 출력을 사용 하는 클라이언트는 파이프 메서드, 중첩 된 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가 4,000자를 넘습니다.

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 이벤트입니다.