다음을 통해 공유


스트리밍 메시지 전송

WCF(Windows Communication Foundation) 전송에서는 다음과 같은 두 가지 메시지 전송 모드를 지원합니다.

  • 버퍼링 전송에서는 전송이 완료될 때까지 전체 메시지를 메모리 버퍼에 보관합니다. 버퍼링된 메시지는 수신기에서 읽기 전에 완전히 전달되어야 합니다.
  • 스트리밍 전송에서는 메시지를 스트림으로 노출합니다. 수신기는 전달이 완료되기 전에 메시지 처리를 시작합니다.
  • 스트리밍 전송은 대용량 메모리 버퍼에 대한 요구 사항을 제거하여 서비스 확장성을 향상시킬 수 있습니다. 전송 모드를 변경하면 확장성이 향상되는지 여부는 전송할 메시지의 크기에 따라 다릅니다. 메시지의 크기가 클수록 스트리밍 전송을 사용하는 것이 좋습니다.

기본적으로 HTTP, TCP/IP 및 명명된 파이프 전송에서는 버퍼링 전송을 사용합니다. 이 문서에서는 이러한 전송을 버퍼링 전송 모드에서 스트리밍 전송 모드로 전환하는 방법과 그 결과에 대해 설명합니다.

스트리밍 전송 사용

버퍼링 전송 모드와 스트리밍 전송 모드의 선택은 전송의 바인딩 요소에서 수행됩니다. 바인딩 요소에는 Buffered, Streamed, StreamedRequest 또는 StreamedResponse로 설정할 수 있는 TransferMode 속성이 있습니다. 전송 모드를 Streamed로 설정하면 양방향 스트리밍 통신이 가능합니다. 전송 모드를 StreamedRequest 또는 StreamedResponse로 설정하면 표시된 방향으로만 스트리밍 통신이 가능합니다.

BasicHttpBinding, NetTcpBindingNetNamedPipeBinding 바인딩은 TransferMode 속성을 노출합니다. 다른 전송의 경우 전송 모드를 설정하려면 사용자 지정 바인딩을 만들어야 합니다.

버퍼링 전송 또는 스트리밍 전송 중 어느 것을 사용할 것인지를 결정하는 것은 끝점의 로컬 결정입니다. HTTP 전송의 경우 전송 모드는 연결 전체 또는 서버 및 다른 매개로 전파되지 않습니다. 서비스 인터페이스의 설명에 전송 모드 설정이 반영되지 않았습니다. 서비스에 대한 클라이언트 클래스를 생성하고 나면 스트리밍 전송에서 모드 설정에 사용할 서비스의 구성 파일을 편집해야 합니다. TCP 및 명명된 파이프 전송의 경우에는 전송 모드가 정책 어설션으로 전파됩니다.

코드 샘플은 방법: 스트리밍 사용을 참조하십시오.

스트리밍 전송에 대한 제한 사항

스트리밍 전송 모드를 사용하면 런타임에 추가 제한 사항이 적용됩니다.

스트리밍 전송을 통해 발생하는 작업에서 계약은 입력 또는 출력 매개 변수를 최대 하나만 가질 수 있습니다. 해당 매개 변수는 메시지의 전체 본문에 해당하며 Message, Stream의 파생 형식 또는 IXmlSerializable 구현이어야 합니다. 작업에 대한 반환 값을 지정하는 것은 출력 매개 변수를 지정하는 것과 같습니다.

신뢰할 수 있는 메시징, 트랜잭션 및 SOAP 메시지 수준 보안과 같은 일부 WCF 기능은 버퍼링 메시지를 사용하여 전송합니다. 이러한 기능을 사용하면 스트리밍을 통해 얻는 성능 이점이 감소되거나 제거될 수 있습니다. 스트리밍 전송을 보안하려면 전송 수준 보안만 사용하거나 전송 수준 보안과 인증 전용 메시지 보안을 함께 사용합니다.

SOAP 헤더는 전송 모드가 스트리밍으로 설정되어 있더라도 항상 버퍼링됩니다. 메시지의 헤더의 크기는 MaxBufferSize 전송 할당량을 초과할 수 없습니다. 이 설정에 대한 자세한 내용은 , 전송 할당량을 참조하십시오.

버퍼링 전송과 스트리밍 전송 사이의 차이점

전송 모드를 버퍼링 전송에서 스트리밍 전송으로 변경하면 TCP 및 명명된 파이프 전송의 기본 채널 셰이프도 함께 변경됩니다. 버퍼링 전송의 기본 채널 셰이프는 IDuplexSessionChannel입니다. 스트리밍 전송의 기본 채널은 IRequestChannelIReplyChannel입니다. 서비스 계약을 통하지 않고 이러한 전송을 직접 사용하는 기존 응용 프로그램에서 전송 모드를 변경하려면 채널 팩터리 및 수신기에 대한 예상 채널 셰이프를 변경해야 합니다.

참고 항목

작업

방법: 스트리밍 사용