ChannelDispatcher 類別

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v8.0.0

來源:

ChannelDispatcher.cs

元件，它會接受通道且使通道與服務產生關聯。

public ref class ChannelDispatcher : System::ServiceModel::Dispatcher::ChannelDispatcherBase

public class ChannelDispatcher : System.ServiceModel.Dispatcher.ChannelDispatcherBase

type ChannelDispatcher = class
    inherit ChannelDispatcherBase

Public Class ChannelDispatcher
Inherits ChannelDispatcherBase

繼承

Object

CommunicationObject

ChannelDispatcherBase

ChannelDispatcher

範例

Uri baseAddress = new Uri("http://localhost:8001/Simple");
ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);

serviceHost.AddServiceEndpoint(
    typeof(ICalculator),
    new WSHttpBinding(),
    "CalculatorServiceObject");

// Enable MEX.
ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
smb.HttpGetEnabled = true;
serviceHost.Description.Behaviors.Add(smb);

serviceHost.Open();

IChannelListener icl = serviceHost.ChannelDispatchers[0].Listener;
ChannelDispatcher dispatcher = new ChannelDispatcher(icl);
Console.WriteLine("servicehost has {0} ChannelDispatchers", serviceHost.ChannelDispatchers.Count);
ChannelDispatcherCollection dispatchers = serviceHost.ChannelDispatchers;

foreach (ChannelDispatcher disp in dispatchers)
{
    Console.WriteLine("Binding name: " + disp.BindingName);
}

Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();

// Close the ServiceHostBase to shutdown the service.
serviceHost.Close();

Dim baseAddress As New Uri("http://localhost:8001/Simple")
Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)

serviceHost.AddServiceEndpoint(GetType(ICalculator), New WSHttpBinding(), "CalculatorServiceObject")

' Enable MEX.
Dim smb As New ServiceMetadataBehavior()
smb.HttpGetEnabled = True
serviceHost.Description.Behaviors.Add(smb)

serviceHost.Open()

Dim icl As IChannelListener = serviceHost.ChannelDispatchers(0).Listener
Dim dispatcher As New ChannelDispatcher(icl)
Console.WriteLine("servicehost has {0} ChannelDispatchers", serviceHost.ChannelDispatchers.Count)
Dim dispatchers As ChannelDispatcherCollection = serviceHost.ChannelDispatchers

For Each disp As ChannelDispatcher In dispatchers
    Console.WriteLine("Binding name: " & disp.BindingName)
Next disp

Console.WriteLine("The service is ready.")
Console.WriteLine("Press <ENTER> to terminate service.")
Console.WriteLine()
Console.ReadLine()

' Close the ServiceHostBase to shutdown the service.
serviceHost.Close()

備註

ChannelDispatcher 物件會透過服務執行個體，與位於特定 URI (稱為接聽 URI) 的 IChannelListener 產生關聯。 每個 ServiceHost 物件都可以擁有許多 ChannelDispatcher 物件，而其中每一個物件都會與該服務的不同接聽程式 (Listener) 和接聽 URI 具有關聯。

當訊息抵達時，ChannelDispatcher 會查詢每個關聯的 EndpointDispatcher 物件來判定該端點是否可以接受此訊息，然後將該訊息傳遞至可以接受的端點。 當訊息的目的端位址與 EndpointDispatcher 屬性相符，且訊息動作符合 ChannelDispatcher 屬性時，AddressFilter 物件就會負責處理來自 ContractFilter 的訊息。

所有控制通道工作階段之存留期及行為的屬性都可以用來檢查或修改 ChannelDispatcher 物件， 除了 EndpointDispatcher 之外，這些還包括自訂 IChannelInitializer 物件、IChannelListener、ServiceHost、目前相關聯的物件和 InstanceContext。

屬性

DefaultCloseTimeout	取得允許通道發送器關閉的預設時間間隔。
DefaultOpenTimeout	取得允許通道發送器開啟的預設時間間隔。
Endpoints	取得轉送訊息至通道端點的端點發送器。
ErrorHandlers	取得 IErrorHandler 物件集合，您可以使用這些物件來為端點插入自訂錯誤處理功能。
Host	在衍生類別中覆寫時，取得與通道發送器相關聯的服務主機。 (繼承來源 ChannelDispatcherBase)
IncludeExceptionDetailInFaults	取得或設定值，這個值會指定是否要在錯誤中包含例外狀況的詳細資訊。
IsDisposed	取得值，這個值會指出是否已經處置通訊物件。 (繼承來源 CommunicationObject)
Listener	取得與通道發送器關聯的接聽程式。
ManualAddressing	取得或設定值，這個值會指出通道發送器是否將定址標頭加入至要求-回覆訊息。
MaxPendingReceives	取得或設定每個通道的最大暫止訊息數目。
MaxTransactedBatchSize	取得或設定交易批次的大小上限。
MessageVersion	取得或設定已使用或需要使用的 SOAP 訊息和 WS-Addressing 版本。
ReceiveContextEnabled	取得或設定是否已啟用 ReceiveContext。
ReceiveSynchronously	取得或設定值，這個值會指定發送器是否使用同步呼叫來讀取通道中的訊息。
SendAsynchronously	取得或設定是否以非同步方式傳送訊息。
State	取得值，這個值表示通訊物件目前的狀態。 (繼承來源 CommunicationObject)
ThisLock	取得會在狀態轉換期間保護類別執行個體的互斥鎖定。 (繼承來源 CommunicationObject)

方法

Abort()	導致通訊物件立即從目前的狀態轉換為關閉狀態。 (繼承來源 CommunicationObject)
Attach(ServiceHostBase)	在衍生類別中覆寫時，將通道發送器附加至特定的主機。 (繼承來源 ChannelDispatcherBase)
BeginClose(AsyncCallback, Object)	開始非同步作業以關閉通訊物件。 (繼承來源 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	開始非同步作業，關閉有已指定逾時的通訊物件。 (繼承來源 CommunicationObject)
BeginOpen(AsyncCallback, Object)	開始非同步作業以開啟通訊物件。 (繼承來源 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	開始非同步作業，開啟有已指定時間間隔的通訊物件。 (繼承來源 CommunicationObject)
Close()	導致通訊物件從目前的狀態轉換為已關閉狀態。 (繼承來源 CommunicationObject)
Close(TimeSpan)	在指定時間間隔內，讓通訊物件從目前的狀態轉換為已關閉狀態。 (繼承來源 CommunicationObject)
CloseInput()	停止接聽程式接受新通道。
Detach(ServiceHostBase)	在衍生類別中覆寫時，從特定主機中斷通道發送器的連結。 (繼承來源 ChannelDispatcherBase)
EndClose(IAsyncResult)	完成非同步作業以關閉通訊物件。 (繼承來源 CommunicationObject)
EndOpen(IAsyncResult)	完成非同步作業以開啟通訊物件。 (繼承來源 CommunicationObject)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Fault()	導致通訊物件從目前的狀態轉換為錯誤狀態。 (繼承來源 CommunicationObject)
GetCommunicationObjectType()	取得通訊物件的型別。 (繼承來源 CommunicationObject)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnAbort()	中止與發送器相關聯的接聽程式。
OnBeginClose(TimeSpan, AsyncCallback, Object)	開始進行關閉發送器之通道接聽程式的非同步作業，此作業必須在指定的時間間隔內完成。
OnBeginOpen(TimeSpan, AsyncCallback, Object)	開始進行開啟發送器之通道接聽程式的非同步作業，此作業必須在指定的時間間隔內完成。
OnClose(TimeSpan)	在指定的時間間隔內關閉與發送器相關聯的通道接聽程式。
OnCloseAsync(TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。
OnClosed()	提供追蹤與通道發送器相關聯之端點發送器關閉作業的功能。
OnClosing()	在將通訊物件轉換為關閉狀態期間會叫用。 (繼承來源 CommunicationObject)
OnEndClose(IAsyncResult)	完成要關閉發送器之通道接聽程式的非同步作業。
OnEndOpen(IAsyncResult)	完成要開啟發送器之通道接聽程式的非同步作業。
OnFaulted()	在通訊物件上插入處理 (當它因為叫用同步錯誤作業而轉換到錯誤狀態之後)。 (繼承來源 CommunicationObject)
OnOpen(TimeSpan)	開啟與通道發送器相關聯的接聽程式。
OnOpenAsync(TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。
OnOpened()	填入並驗證用來分派至端點的篩選資料表。
OnOpening()	檢查通道發送器是否已附加至主機。
Open()	導致通訊物件從已建立狀態轉換為已開啟狀態。 (繼承來源 CommunicationObject)
Open(TimeSpan)	在指定時間間隔內，讓通訊物件從已建立狀態轉換為已開啟狀態。 (繼承來源 CommunicationObject)
ThrowIfDisposed()	如果已處置通訊物件，則會擲回例外狀況。 (繼承來源 CommunicationObject)
ThrowIfDisposedOrImmutable()	如果通訊物件的 State 屬性並未設定為 Created 狀態，就會擲回例外狀況。 (繼承來源 CommunicationObject)
ThrowIfDisposedOrNotOpen()	如果通訊物件不是處於 Opened 狀態，就會擲回例外狀況。 (繼承來源 CommunicationObject)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

Closed	當通訊物件轉換至已關閉狀態時發生。 (繼承來源 CommunicationObject)
Closing	當通訊物件轉換至關閉狀態時就會發生。 (繼承來源 CommunicationObject)
Faulted	當通訊物件轉換至錯誤狀態時發生。 (繼承來源 CommunicationObject)
Opened	當通訊物件轉換至已開啟狀態時發生。 (繼承來源 CommunicationObject)
Opening	當通訊物件轉換至開啟狀態時發生。 (繼承來源 CommunicationObject)

明確介面實作

IAsyncCommunicationObject.CloseAsync(TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。 (繼承來源 CommunicationObject)
IAsyncCommunicationObject.OpenAsync(TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。 (繼承來源 CommunicationObject)

擴充方法

CloseHelperAsync(ICommunicationObject, TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。
OpenHelperAsync(ICommunicationObject, TimeSpan)	元件，它會接受通道且使通道與服務產生關聯。
GetInternalCloseTimeout(CommunicationObject)	元件，它會接受通道且使通道與服務產生關聯。