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();
}
下面的代码示例演示如何在工厂创建通道对象之前以编程方式插入客户端行为。
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) |
配置如何执行从异步可释放项返回的任务的 await。 |
适用于
线程安全性
此类型是线程安全的。
