ChannelFactory<TChannel> 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
建立客戶端用來將訊息傳送至各種設定服務端點之不同類型通道的處理站。
generic <typename TChannel>
public ref class ChannelFactory : System::ServiceModel::ChannelFactory, System::ServiceModel::Channels::IChannelFactory<TChannel>public class ChannelFactory<TChannel> : System.ServiceModel.ChannelFactory, System.ServiceModel.Channels.IChannelFactory<TChannel>type ChannelFactory<'Channel> = class
inherit ChannelFactory
interface IChannelFactory<'Channel>
interface IChannelFactory
interface ICommunicationObjecttype ChannelFactory<'Channel> = class
inherit ChannelFactory
interface IChannelFactory
interface ICommunicationObject
interface IChannelFactory<'Channel>Public Class ChannelFactory(Of TChannel)
Inherits ChannelFactory
Implements IChannelFactory(Of TChannel)類型參數
- TChannel
通道處理站所產生的通道類型。 這個類型必須是 IOutputChannel 或 IRequestChannel。
- 繼承
- 衍生
- 實作
範例
下列範例示範如何建立通道處理站，並用它來建立和管理通道。
BasicHttpBinding binding = new BasicHttpBinding();
EndpointAddress address = new EndpointAddress("http://localhost:8000/ChannelApp");
ChannelFactory<IRequestChannel> factory =
new ChannelFactory<IRequestChannel>(binding, address);
IRequestChannel channel = factory.CreateChannel();
channel.Open();
Message request = Message.CreateMessage(MessageVersion.Soap11, "hello");
Message reply = channel.Request(request);
Console.Out.WriteLine(reply.Headers.Action);
reply.Close();
channel.Close();
factory.Close();
}
下列程式代碼範例示範如何在 Factory 建立通道物件之前，以程式設計方式插入客戶端行為。
public class Client
{
public static void Main()
{
try
{
// Picks up configuration from the config file.
ChannelFactory<ISampleServiceChannel> factory
= new ChannelFactory<ISampleServiceChannel>("WSHttpBinding_ISampleService");
// Add the client side behavior programmatically to all created channels.
factory.Endpoint.Behaviors.Add(new EndpointBehaviorMessageInspector());
ISampleServiceChannel wcfClientChannel = factory.CreateChannel();
// Making calls.
Console.WriteLine("Enter the greeting to send: ");
string greeting = Console.ReadLine();
Console.WriteLine("The service responded: " + wcfClientChannel.SampleMethod(greeting));
Console.WriteLine("Press ENTER to exit:");
Console.ReadLine();
// Done with service.
wcfClientChannel.Close();
Console.WriteLine("Done!");
}
catch (TimeoutException timeProblem)
{
Console.WriteLine("The service operation timed out. " + timeProblem.Message);
Console.Read();
}
catch (FaultException<SampleFault> fault)
{
Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage);
Console.Read();
}
catch (CommunicationException commProblem)
{
Console.WriteLine("There was a communication problem. " + commProblem.Message);
Console.Read();
}
}
Public Class Client
Public Shared Sub Main()
Try
' Picks up configuration from the config file.
Dim factory As New ChannelFactory(Of ISampleServiceChannel)("WSHttpBinding_ISampleService")
' Add the client side behavior programmatically to all created channels.
factory.Endpoint.Behaviors.Add(New EndpointBehaviorMessageInspector())
Dim wcfClientChannel As ISampleServiceChannel = factory.CreateChannel()
' Making calls.
Console.WriteLine("Enter the greeting to send: ")
Dim greeting As String = Console.ReadLine()
Console.WriteLine("The service responded: " & wcfClientChannel.SampleMethod(greeting))
Console.WriteLine("Press ENTER to exit:")
Console.ReadLine()
' Done with service.
wcfClientChannel.Close()
Console.WriteLine("Done!")
Catch timeProblem As TimeoutException
Console.WriteLine("The service operation timed out. " & timeProblem.Message)
Console.Read()
Catch fault As FaultException(Of SampleFault)
Console.WriteLine("SampleFault fault occurred: {0}", fault.Detail.FaultMessage)
Console.Read()
Catch commProblem As CommunicationException
Console.WriteLine("There was a communication problem. " & commProblem.Message)
Console.Read()
End Try
End Sub
備註
此泛型類別可啟用更進階的案例，其中需要建立可用來建立多個通道類型的通道處理站。
以程序設計方式新增行為時，行為會在建立任何通道之前，新增至 ChannelFactory 上適當的 Behaviors 屬性。 如需程式代碼範例，請參閱範例一節。
經常使用這個類型的用戶端或呼叫應用程式（例如，仲介層應用程式也是用戶端應用程式），也有複雜的狀態管理需求以及效能需求。 如需這些案例的詳細資訊，請參閱 Middle-Tier 用戶端應用程式。
建構函式
| ChannelFactory<TChannel>() |
初始化 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(Binding) |
初始化 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(Binding, EndpointAddress) |
使用指定的系結和端點位址，初始化 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(Binding, String) |
使用指定的系結和遠端位址，初始化 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(ServiceEndpoint) |
初始化 ChannelFactory<TChannel> 類別的新實例，這個實例會產生具有指定端點的通道。 |
| ChannelFactory<TChannel>(String) |
使用指定的端點組態名稱，初始化 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(String, EndpointAddress) |
初始化與端點組態和遠端位址指定名稱相關聯的 ChannelFactory<TChannel> 類別的新實例。 |
| ChannelFactory<TChannel>(Type) |
初始化 ChannelFactory<TChannel> 類別的新實例。 |
屬性
| Credentials |
取得客戶端用來透過處理站所產生的通道來通訊服務端點的認證。 (繼承來源 ChannelFactory) |
| DefaultCloseTimeout |
取得為關閉作業完成所提供的預設時間間隔。 (繼承來源 ChannelFactory) |
| DefaultOpenTimeout |
取得開啟作業要完成的預設時間間隔。 (繼承來源 ChannelFactory) |
| Endpoint |
取得處理站所產生通道所連線的服務端點。 (繼承來源 ChannelFactory) |
| IsDisposed |
取得值，這個值表示是否已處置通訊物件。 (繼承來源 CommunicationObject) |
| State |
取得值，這個值表示通訊物件的目前狀態。 (繼承來源 CommunicationObject) |
| ThisLock |
取得在狀態轉換期間保護類別實例的互斥鎖定。 (繼承來源 CommunicationObject) |
方法
事件
| Closed |
當通訊物件轉換成關閉狀態時發生。 (繼承來源 CommunicationObject) |
| Closing |
當通訊物件轉換成關閉狀態時發生。 (繼承來源 CommunicationObject) |
| Faulted |
當通訊物件轉換成錯誤狀態時發生。 (繼承來源 CommunicationObject) |
| Opened |
當通訊物件轉換成開啟的狀態時發生。 (繼承來源 CommunicationObject) |
| Opening |
當通訊物件轉換成開啟狀態時發生。 (繼承來源 CommunicationObject) |
明確介面實作
| IAsyncDisposable.DisposeAsync() |
建立客戶端用來將訊息傳送至各種設定服務端點之不同類型通道的處理站。 (繼承來源 ChannelFactory) |
| IDisposable.Dispose() |
關閉目前的通道處理站。 (繼承來源 ChannelFactory) |
擴充方法
| ConfigureAwait(IAsyncDisposable, Boolean) |
設定如何執行從異步可處置專案傳回的工作等候。 |
適用於
執行緒安全性
此類型是安全線程。
