CallbackBehaviorAttribute 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v10.0.652802

來源:

CallbackBehaviorAttribute.cs

在用戶端應用程式中設定回呼服務實作。

public ref class CallbackBehaviorAttribute sealed : Attribute, System::ServiceModel::Description::IEndpointBehavior

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class CallbackBehaviorAttribute : Attribute, System.ServiceModel.Description.IEndpointBehavior

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type CallbackBehaviorAttribute = class
    inherit Attribute
    interface IEndpointBehavior

Public NotInheritable Class CallbackBehaviorAttribute
Inherits Attribute
Implements IEndpointBehavior

繼承

Object

Attribute

CallbackBehaviorAttribute

屬性

AttributeUsageAttribute

範例

以下程式碼範例展示了 CallbackBehaviorAttribute 一個回調物件，該物件使用 SynchronizationContext 該物件決定要編入哪個執行緒、 ValidateMustUnderstand 強制訊息驗證的屬性，以及 IncludeExceptionDetailInFaults 將例外作為 FaultException 物件回傳給服務以供除錯目的的物件。

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();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Threading

Namespace Microsoft.WCF.Documentation
  <CallbackBehaviorAttribute(IncludeExceptionDetailInFaults:= True, UseSynchronizationContext:=True, ValidateMustUnderstand:=True)> _
  Public Class Client
      Implements SampleDuplexHelloCallback
    Private waitHandle As AutoResetEvent

    Public Sub New()
      waitHandle = New AutoResetEvent(False)
    End Sub

    Public Sub Run()
      ' Picks up configuration from the configuration file.
      Dim wcfClient As New SampleDuplexHelloClient(New InstanceContext(Me), "WSDualHttpBinding_SampleDuplexHello")
      Try
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Enter a greeting to send and press ENTER: ")
        Console.Write(">>> ")
        Console.ForegroundColor = ConsoleColor.Green
        Dim greeting As String = Console.ReadLine()
        Console.ForegroundColor = ConsoleColor.White
        Console.WriteLine("Called service with: " & Constants.vbCrLf & Constants.vbTab & greeting)
        wcfClient.Hello(greeting)
        Console.WriteLine("Execution passes service call and moves to the WaitHandle.")
        Me.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 timeProblem As TimeoutException
        Console.WriteLine("The service operation timed out. " & timeProblem.Message)
        Console.ReadLine()
      Catch commProblem As CommunicationException
        Console.WriteLine("There was a communication problem. " & commProblem.Message)
        Console.ReadLine()
      End Try
    End Sub
    Public Shared Sub Main()
      Dim client As New Client()
      client.Run()
    End Sub

    Public Sub Reply(ByVal response As String) Implements SampleDuplexHelloCallback.Reply
      Console.WriteLine("Received output.")
      Console.WriteLine(Constants.vbCrLf & Constants.vbTab & response)
      Me.waitHandle.Set()
    End Sub
  End Class
End Namespace

備註

利用該 CallbackBehaviorAttribute 屬性來設定或擴展客戶端應用程式中回調合約實作的執行行為。 此屬性對回調類別執行與屬性 ServiceBehaviorAttribute 相同的功能，唯獨在實例化行為與交易設定上有所不同。

CallbackBehaviorAttribute必須套用到實作回調合約的類別。 若應用於非雙工合約實作 InvalidOperationException ，執行時會拋出例外。

備註

你也可以用這個 OperationBehaviorAttribute 屬性來實作回調操作。 然而，若 OperationBehaviorAttribute 在回調操作中使用，則必須具備 ReleaseInstanceMode 該屬性， None 否則 InvalidOperationException 執行時會拋出例外。

下列屬性可供使用：

• 當通道關閉且回調完成剩餘訊息處理時，該 AutomaticSessionShutdown 屬性會自動關閉會話。

• 此 ConcurrencyMode 特性控制內部執行緒模型，支援重入式或多執行緒回調物件。

• 此 IgnoreExtensionDataObject 特性使執行時能忽略處理訊息所需的額外序列化資訊。

• 此 IncludeExceptionDetailInFaults 特性指定服務中未處理的例外是否會以 SOAP 錯誤形式回傳至服務以供除錯。

• 該 MaxItemsInObjectGraph 性質限制了物件圖中序列化項目的數量。

• 屬性 TransactionIsolationLevel 指定了合約所支援的交易隔離層級。

• 該 TransactionTimeout 屬性指定交易必須在期限內完成或終止。

• 屬性 UseSynchronizationContext 表示是否要用目前 SynchronizationContext 物件自動同步入站的方法呼叫。

• 該 ValidateMustUnderstand 屬性會告知系統是否應該確認標記為 MustUnderstand 的 SOAP 標頭確實已被理解。

建構函式

名稱	Description
CallbackBehaviorAttribute()	初始化 CallbackBehaviorAttribute 類別的新執行個體。

屬性

名稱	Description
AutomaticSessionShutdown	規定當服務關閉雙工會話時，是否自動關閉會話。
ConcurrencyMode	接收或設定服務是否支援單一執行緒、多個執行緒，或是重入呼叫。
UseSynchronizationContext	取得或設定一個值，指定是否使用目前的同步上下文來選擇執行執行緒。

明確介面實作

名稱	Description
IEndpointBehavior.AddBindingParameters(ServiceEndpoint, BindingParameterCollection)	配置綁定元素以支援回調行為。
IEndpointBehavior.ApplyClientBehavior(ServiceEndpoint, ClientRuntime)	配置客戶端執行時以支援回調物件。
IEndpointBehavior.ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher)	方法的 ApplyDispatchBehavior(ServiceEndpoint, EndpointDispatcher) 實作。 此實施無效。
IEndpointBehavior.Validate(ServiceEndpoint)	在建置執行時前驗證端點描述。