ServiceHostBase 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
扩展 ServiceHostBase 类，以实现可公开自定义编程模型的主机。
public ref class ServiceHostBase abstract : System::ServiceModel::Channels::CommunicationObject, IDisposable, System::ServiceModel::IExtensibleObject<System::ServiceModel::ServiceHostBase ^>public abstract class ServiceHostBase : System.ServiceModel.Channels.CommunicationObject, IDisposable, System.ServiceModel.IExtensibleObject<System.ServiceModel.ServiceHostBase>type ServiceHostBase = class
inherit CommunicationObject
interface IExtensibleObject<ServiceHostBase>
interface IDisposablePublic MustInherit Class ServiceHostBase
Inherits CommunicationObject
Implements IDisposable, IExtensibleObject(Of ServiceHostBase)- 继承
- 派生
- 实现
示例
此示例使用 ServiceHost 派生自 ServiceHostBase的 类。
// Host the service within this EXE console application.
public static void Main()
{
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))
{
try
{
// Open the ServiceHost to start listening for messages.
serviceHost.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.ReadLine();
// Close the ServiceHost.
serviceHost.Close();
}
catch (TimeoutException timeProblem)
{
Console.WriteLine(timeProblem.Message);
Console.ReadLine();
}
catch (CommunicationException commProblem)
{
Console.WriteLine(commProblem.Message);
Console.ReadLine();
}
}
}
' Host the service within this EXE console application.
Public Shared Sub Main()
' Create a ServiceHost for the CalculatorService type and use the base address from config.
Using svcHost As New ServiceHost(GetType(CalculatorService))
Try
' Open the ServiceHost to start listening for messages.
svcHost.Open()
' The service can now be accessed.
Console.WriteLine("The service is ready.")
Console.WriteLine("Press <ENTER> to terminate service.")
Console.WriteLine()
Console.ReadLine()
'Close the ServiceHost.
svcHost.Close()
Catch timeout As TimeoutException
Console.WriteLine(timeout.Message)
Console.ReadLine()
Catch commException As CommunicationException
Console.WriteLine(commException.Message)
Console.ReadLine()
End Try
End Using
End Sub
注解
ServiceHostBase使用 类创建提供自定义编程模型的主机。 Windows Communication Foundation (WCF) 服务编程模型使用 ServiceHost 类。
针对从此类派生的托管 C++ 用户的特别说明：
将清理代码放入 (On)(Begin)Close（和/或 OnAbort）中，而不是放入析构函数中。
避免使用析构函数；它们会导致编译器自动生成 IDisposable。
避免使用非引用成员；它们可能会导致编译器自动生成 IDisposable。
避免使用终结器；但如果包含一个终结器，则应该禁止显示生成警告并从 (On)(Begin)Close（和/或 OnAbort）调用 SuppressFinalize(Object) 和终结器本身，以便模拟自动生成的 IDisposable 行为。
构造函数
| ServiceHostBase() |
初始化 ServiceHostBase 类的新实例。 |
属性
| Authentication |
获取服务身份验证行为。 |
| Authorization |
获取所承载服务的授权行为。 |
| BaseAddresses |
获取所承载服务使用的基址。 |
| ChannelDispatchers |
获取服务主机所使用的通道调度程序的集合。 |
| CloseTimeout |
获取或设置允许服务主机关闭的时间间隔。 |
| Credentials |
获取所承载服务的凭据。 |
| DefaultCloseTimeout |
获取允许服务主机关闭的默认时间间隔。 |
| DefaultOpenTimeout |
获取允许服务主机打开的默认时间间隔。 |
| Description |
获取所承载服务的说明。 |
| Extensions |
获取当前指定的服务主机的扩展。 |
| ImplementedContracts |
检索由所承载服务实现的协定。 |
| IsDisposed |
获取一个值，该值指示通信对象是否已被释放。 (继承自 CommunicationObject) |
| ManualFlowControlLimit |
获取或设置由所承载服务接收的消息的流控制限制。 |
| OpenTimeout |
获取或设置允许服务主机打开的时间间隔。 |
| State |
获取指示通信对象当前状态的值。 (继承自 CommunicationObject) |
| ThisLock |
获取在状态转换过程中保护类实例的相互排斥锁。 (继承自 CommunicationObject) |
方法
事件
| Closed |
当通信对象转换到已关闭状态时发生。 (继承自 CommunicationObject) |
| Closing |
当通信对象转换到正在关闭状态时发生。 (继承自 CommunicationObject) |
| Faulted |
在通信对象转换到出错状态时发生。 (继承自 CommunicationObject) |
| Opened |
当通信对象转换到已打开状态时发生。 (继承自 CommunicationObject) |
| Opening |
当通信对象转换到正在打开状态时发生。 (继承自 CommunicationObject) |
| UnknownMessageReceived |
接收未知消息时发生。 |
显式接口实现
| IDisposable.Dispose() |
关闭服务主机。 |
