내보내기(0) 인쇄
모두 확장
이 문서는 수동으로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오.
번역
원본

CallbackBehaviorAttribute 클래스

클라이언트 응용 프로그램에서 콜백 서비스 구현을 구성합니다.

System.Object
  System.Attribute
    System.ServiceModel.CallbackBehaviorAttribute

네임스페이스:  System.ServiceModel
어셈블리:  System.ServiceModel(System.ServiceModel.dll)

[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class CallbackBehaviorAttribute : Attribute, 
	IEndpointBehavior

CallbackBehaviorAttribute 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드CallbackBehaviorAttribute CallbackBehaviorAttribute 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성AutomaticSessionShutdown서비스가 이중 세션을 닫을 때 자동으로 세션을 닫을지 여부를 지정합니다.
Public 속성ConcurrencyMode서비스가 하나의 스레드, 여러 개의 스레드 또는 재진입 호출을 지원할지 여부를 가져오거나 설정합니다.
Public 속성IgnoreExtensionDataObject네트워크에서 알 수 없는 serialization 데이터를 보낼지 여부를 지정하는 값을 가져오거나 설정합니다.
Public 속성IncludeExceptionDetailInFaults처리되지 않은 일반적인 실행 예외를 String 형식의 FaultException<TDetail>으로 변환하고 오류 메시지로 보내도록 지정하는 값을 가져오거나 설정합니다.서비스 문제를 해결하려면 개발하는 동안에만 이 값을 true로 설정합니다.
Public 속성MaxItemsInObjectGraphserialize된 개체에 허용되는 최대 항목 수를 가져오거나 설정합니다.
Public 속성TransactionIsolationLevel트랜잭션 격리 수준을 지정합니다.
Public 속성TransactionTimeout트랜잭션을 완료해야 하는 기간을 가져오거나 설정합니다.
Public 속성TypeId파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (Attribute에서 상속됨)
Public 속성UseSynchronizationContext현재 동기화 컨텍스트를 사용하여 실행 스레드를 선택할지 여부를 지정하는 값을 가져오거나 설정합니다.
Public 속성ValidateMustUnderstandSOAP MustUnderstand 헤더 처리를 시스템에서 수행하는지 아니면 응용 프로그램에서 수행하는지를 지정하는 값을 가져오거나 설정합니다.
위쪽

  이름설명
Public 메서드Equals인프라입니다. 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCode이 인스턴스에 대한 해시 코드를 반환합니다. (Attribute에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드IsDefaultAttribute파생 클래스에서 재정의된 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (Attribute에서 상속됨)
Public 메서드Match파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
위쪽

  이름설명
명시적 인터페이스 구현Private 메서드_Attribute.GetIDsOfNames이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다. (Attribute에서 상속됨)
명시적 인터페이스 구현Private 메서드_Attribute.GetTypeInfo인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다. (Attribute에서 상속됨)
명시적 인터페이스 구현Private 메서드_Attribute.GetTypeInfoCount개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1). (Attribute에서 상속됨)
명시적 인터페이스 구현Private 메서드_Attribute.Invoke개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다. (Attribute에서 상속됨)
명시적 인터페이스 구현Private 메서드IEndpointBehavior.AddBindingParameters콜백 동작을 지원하도록 바인딩 요소를 구성합니다.
명시적 인터페이스 구현Private 메서드IEndpointBehavior.ApplyClientBehavior콜백 개체를 지원하도록 클라이언트 런타임을 구성합니다.
명시적 인터페이스 구현Private 메서드IEndpointBehavior.ApplyDispatchBehavior ApplyDispatchBehavior 메서드의 구현입니다.이 구현은 아무 작업도 수행하지 않습니다.
명시적 인터페이스 구현Private 메서드IEndpointBehavior.Validate런타임을 빌드하기 전에 끝점 설명의 유효성을 검사합니다.
위쪽

CallbackBehaviorAttribute 특성을 사용하여 클라이언트 응용 프로그램에서 콜백 계약 구현의 실행 동작을 구성하거나 확장할 수 있습니다.이 특성은 인스턴스 동작과 트랜잭션 설정을 제외하고 ServiceBehaviorAttribute 특성과 동일한 기능을 콜백 클래스에 대해 수행합니다.

CallbackBehaviorAttribute 는 콜백 계약을 구현하는 클래스에 적용해야 합니다.비이중 계약 구현에 적용하면 런타임에 InvalidOperationException 예외가 throw됩니다.

참고참고

또한 콜백 작업 구현에 OperationBehaviorAttribute 특성을 사용할 수도 있습니다.그러나 콜백 작업에서 OperationBehaviorAttribute를 사용하는 경우 ReleaseInstanceMode 속성이 None이어야 하며, 그렇지 않으면 런타임에 InvalidOperationException 예외가 throw됩니다.

사용할 수 있는 속성은 다음과 같습니다.

  • AutomaticSessionShutdown 속성은 채널이 닫히고 콜백이 나머지 메시지의 처리를 마쳤을 때 자동으로 세션을 닫습니다.

  • ConcurrencyMode 속성은 내부 스레딩 모델을 제어하여 재진입 콜백 개체나 다중 스레드 콜백 개체의 지원을 가능하게 합니다.

  • IgnoreExtensionDataObject 속성을 사용하면 메시지 처리에 필요 없는 추가 serialization 정보가 런타임에 무시됩니다.

  • IncludeExceptionDetailInFaults 속성은 서비스에서 처리되지 않은 예외가 디버깅 목적으로 SOAP 오류로 서비스에 반환되는지 여부를 지정합니다.

  • MaxItemsInObjectGraph 속성은 개체 그래프에서 serialize되는 항목의 수를 제한합니다.

  • TransactionIsolationLevel 속성은 계약이 지원하는 트랜잭션 격리 수준을 지정합니다.

  • TransactionTimeout 속성은 트랜잭션 완료가 이루어지지 않으면 중단되는 기간을 지정합니다.

  • UseSynchronizationContext 속성은 현재 SynchronizationContext 개체를 사용하여 인바운드 메서드 호출을 자동으로 동기화하는지 여부를 나타냅니다.

  • ValidateMustUnderstand 속성은 MustUnderstand로 표시된 SOAP 헤더가 실제로 인식되었음을 확인해야 하는지 여부를 시스템에 알려 줍니다.

다음 코드 예제에서는 SynchronizationContext 개체를 사용하여 마샬링할 스레드를 결정하고, ValidateMustUnderstand 속성을 사용하여 메시지 유효성 검사를 적용하며, 디버깅을 위해 IncludeExceptionDetailInFaults 속성을 사용하여 서비스에 예외를 FaultException 개체로 반환하는 콜백 개체의 CallbackBehaviorAttribute를 보여 줍니다.


using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Threading;

namespace Microsoft.WCF.Documentation
{
  [CallbackBehaviorAttribute(
   IncludeExceptionDetailInFaults= true, 
    UseSynchronizationContext=true,
    ValidateMustUnderstand=true
  )]
  public class Client : SampleDuplexHelloCallback
  {
    AutoResetEvent waitHandle;

    public Client()
    {
      waitHandle = new AutoResetEvent(false);
    }

    public void Run()
    {
      // Picks up configuration from the configuration file.
      SampleDuplexHelloClient wcfClient
        = new SampleDuplexHelloClient(new InstanceContext(this), "WSDualHttpBinding_SampleDuplexHello");
      try
      {
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Enter a greeting to send and press ENTER: ");
        Console.Write(">>> ");
        Console.ForegroundColor = ConsoleColor.Green;
        string greeting = Console.ReadLine();
        Console.ForegroundColor = ConsoleColor.White;
        Console.WriteLine("Called service with: \r\n\t" + greeting);
        wcfClient.Hello(greeting);
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.");
        this.waitHandle.WaitOne();
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.WriteLine("Set was called.");
        Console.Write("Press ");
        Console.ForegroundColor = ConsoleColor.Red;
        Console.Write("ENTER");
        Console.ForegroundColor = ConsoleColor.Blue;
        Console.Write(" to exit...");
        Console.ReadLine();
      }
      catch (TimeoutException timeProblem)
      {
        Console.WriteLine("The service operation timed out. " + timeProblem.Message);
        Console.ReadLine();
      }
      catch (CommunicationException commProblem)
      {
        Console.WriteLine("There was a communication problem. " + commProblem.Message);
        Console.ReadLine();
      }
    }
    public static void Main()
    {
      Client client = new Client();
      client.Run();
    }

    public void Reply(string response)
    {
      Console.WriteLine("Received output.");
      Console.WriteLine("\r\n\t" + response);
      this.waitHandle.Set();
    }
  }
}


.NET Framework

4, 3.5, 3.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft