ChannelFactory 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
创建和管理客户端用来将消息发送到服务终结点的通道。
public ref class ChannelFactory abstract : System::ServiceModel::Channels::CommunicationObject, IDisposable, System::ServiceModel::Channels::IChannelFactory
public ref class ChannelFactory abstract : System::ServiceModel::Channels::CommunicationObject, IAsyncDisposable, IDisposable, System::ServiceModel::Channels::IChannelFactory
public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, IDisposable, System.ServiceModel.Channels.IChannelFactory
public abstract class ChannelFactory : System.ServiceModel.Channels.CommunicationObject, IAsyncDisposable, IDisposable, System.ServiceModel.Channels.IChannelFactory
type ChannelFactory = class
inherit CommunicationObject
interface IDisposable
interface IChannelFactory
interface ICommunicationObject
type ChannelFactory = class
inherit CommunicationObject
interface IChannelFactory
interface ICommunicationObject
interface IDisposable
interface IAsyncDisposable
type ChannelFactory = class
inherit CommunicationObject
interface IChannelFactory
interface ICommunicationObject
interface IDisposable
Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IChannelFactory, IDisposable
Public MustInherit Class ChannelFactory
Inherits CommunicationObject
Implements IAsyncDisposable, IChannelFactory, IDisposable
- 继承
- 派生
- 实现
示例
下面的代码示例演示如何在工厂创建通道对象前,以编程方式插入客户端行为。
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
注解
实现 IChannelFactory 接口的通道工厂及其关联通道一般由通信模式的发起方使用。 而实现 IChannelListener 接口的侦听器工厂及其关联侦听器则提供一些用于接受通道以进行通信的机制。
此类不属于通道模型,而属于服务模型。 CreateFactory 方法提供为服务终结点创建 IChannelFactory 的方式。 使用该方法可以构建与服务上接口协定关联的客户端,而无需使用元数据或策略。
注意
将 ChannelFactory.Credentials.Windows.AllowedImpersonationLevel
设置为 TokenImpersonationLevel.Anonymous
总是会导致匿名登录,而不论模拟级别为何。
针对从此类派生的托管 C++ 用户的特别说明:
将清理代码放入 (On)(Begin)Close(和/或 OnAbort)中,而不是放入析构函数中。
避免使用析构函数;它们会导致编译器自动生成 IDisposable。
避免使用非引用成员;它们可能会导致编译器自动生成 IDisposable。
避免使用终结器;但如果包含一个终结器,则应该禁止显示生成警告并从 (On)(Begin)Close(和/或 OnAbort)调用 SuppressFinalize(Object) 和终结器本身,以便模拟已自动生成的 IDisposable 行为。
以编程方式添加行为时,可以在创建任何通道之前将行为添加到 Behaviors
上相应的 ChannelFactory 属性。 有关代码示例,请参见“示例”部分。
构造函数
ChannelFactory() |
初始化 ChannelFactory 类的新实例。 |
属性
Credentials |
获取客户端在通过由工厂产生的通道与服务终结点进行通信时使用的凭据。 |
DefaultCloseTimeout |
获取为完成关闭操作提供的默认时间间隔。 |
DefaultOpenTimeout |
获取为完成打开操作提供的默认时间间隔。 |
Endpoint |
获取由工厂产生的通道所要连接的服务终结点。 |
IsDisposed |
获取一个值,该值指示通信对象是否已被释放。 (继承自 CommunicationObject) |
State |
获取指示通信对象当前状态的值。 (继承自 CommunicationObject) |
ThisLock |
获取在状态转换过程中保护类实例的相互排斥锁。 (继承自 CommunicationObject) |
方法
事件
Closed |
当通信对象转换到已关闭状态时发生。 (继承自 CommunicationObject) |
Closing |
当通信对象转换到正在关闭状态时发生。 (继承自 CommunicationObject) |
Faulted |
在通信对象转换到出错状态时发生。 (继承自 CommunicationObject) |
Opened |
当通信对象转换到已打开状态时发生。 (继承自 CommunicationObject) |
Opening |
当通信对象转换到正在打开状态时发生。 (继承自 CommunicationObject) |
显式接口实现
IAsyncCommunicationObject.CloseAsync(TimeSpan) |
创建和管理客户端用来将消息发送到服务终结点的通道。 (继承自 CommunicationObject) |
IAsyncCommunicationObject.OpenAsync(TimeSpan) |
创建和管理客户端用来将消息发送到服务终结点的通道。 (继承自 CommunicationObject) |
IAsyncDisposable.DisposeAsync() |
创建和管理客户端用来将消息发送到服务终结点的通道。 |
IDisposable.Dispose() |
关闭当前的通道工厂。 |
扩展方法
CloseHelperAsync(ICommunicationObject, TimeSpan) |
创建和管理客户端用来将消息发送到服务终结点的通道。 |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
创建和管理客户端用来将消息发送到服务终结点的通道。 |
GetInternalCloseTimeout(CommunicationObject) |
创建和管理客户端用来将消息发送到服务终结点的通道。 |
ConfigureAwait(IAsyncDisposable, Boolean) |
配置如何执行从异步可处置项返回的任务的等待。 |
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈