ServiceHostBase 类

定义

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 IDisposable
Public MustInherit Class ServiceHostBase
Inherits CommunicationObject
Implements IDisposable, IExtensibleObject(Of ServiceHostBase)
继承
ServiceHostBase
派生
实现

示例

此示例使用派生自ServiceHostServiceHostBase类。

// 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(and/或 OnAbort),而不是析构函数中。
  • 避免析构函数;它们会导致编译器自动生成 IDisposable
  • 避免非引用成员;它们可能会导致编译器自动生成 IDisposable
  • 避免终结器;但是,如果包含一个,则应禁止生成警告和调用 SuppressFinalize(Object) 以及终结器本身从 (On)(Begin)Close (和/或 OnAbort) 模拟自动生成 IDisposable 的行为。

构造函数

名称 说明
ServiceHostBase()

初始化 ServiceHostBase 类的新实例。

属性

名称 说明
Authentication

获取服务身份验证行为。

Authorization

获取托管的服务的授权行为。

BaseAddresses

获取托管服务使用的基址。

ChannelDispatchers

获取服务主机使用的通道调度程序集合。

CloseTimeout

获取或设置允许服务主机关闭的时间间隔。

Credentials

获取托管服务的凭据。

DefaultCloseTimeout

获取允许服务主机关闭的默认时间间隔。

DefaultOpenTimeout

获取允许服务主机打开的默认时间间隔。

Description

获取托管服务的说明。

Extensions

获取当前指定的服务主机的扩展。

ImplementedContracts

检索由托管服务实现的协定。

IsDisposed

获取一个值,该值指示是否已释放通信对象。

(继承自 CommunicationObject)
ManualFlowControlLimit

获取或设置托管服务接收的消息的流控制限制。

OpenTimeout

获取或设置允许服务主机打开的时间间隔。

State

获取一个值,该值指示通信对象的当前状态。

(继承自 CommunicationObject)
ThisLock

获取在状态转换期间保护类实例的互斥锁。

(继承自 CommunicationObject)

方法

名称 说明
Abort()

使通信对象立即从其当前状态转换为结束状态。

(继承自 CommunicationObject)
AddBaseAddress(Uri)

将基址添加到服务主机。

AddDefaultEndpoints()

使用默认绑定为服务主机中找到的每个协定中的所有基址添加服务终结点。

AddServiceEndpoint(ServiceEndpoint)

将指定的服务终结点添加到托管服务。

AddServiceEndpoint(String, Binding, String, Uri)

使用指定的协定、绑定、终结点地址和 URI 将服务终结点添加到托管服务,其中包含它侦听的地址。

AddServiceEndpoint(String, Binding, String)

使用指定的协定、绑定和终结点地址将服务终结点添加到托管服务。

AddServiceEndpoint(String, Binding, Uri, Uri)

使用包含终结点和侦听地址的指定协定、绑定和 URI 将服务终结点添加到托管服务。

AddServiceEndpoint(String, Binding, Uri)

使用指定的协定、绑定和包含终结点地址的 URI 将服务终结点添加到托管服务。

ApplyConfiguration()

从配置文件加载服务说明信息,并将其应用于正在构造的运行时。

BeginClose(AsyncCallback, Object)

开始异步操作以关闭通信对象。

(继承自 CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

开始异步操作以关闭具有指定超时的通信对象。

(继承自 CommunicationObject)
BeginOpen(AsyncCallback, Object)

开始异步操作以打开通信对象。

(继承自 CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

开始一个异步操作,以在指定的时间间隔内打开通信对象。

(继承自 CommunicationObject)
Close()

使通信对象从其当前状态转换为关闭状态。

(继承自 CommunicationObject)
Close(TimeSpan)

使通信对象在指定的时间间隔内从其当前状态转换为关闭状态。

(继承自 CommunicationObject)
CreateDescription(IDictionary<String,ContractDescription>)

在派生类中实现时,创建托管服务的说明。

EndClose(IAsyncResult)

完成异步操作以关闭通信对象。

(继承自 CommunicationObject)
EndOpen(IAsyncResult)

完成异步操作以打开通信对象。

(继承自 CommunicationObject)
Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
Fault()

使通信对象从其当前状态过渡到错误状态。

(继承自 CommunicationObject)
GetCommunicationObjectType()

获取通信对象的类型。

(继承自 CommunicationObject)
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
IncrementManualFlowControlLimit(Int32)

按指定的增量将消息流速率限制到托管服务。

InitializeDescription(UriSchemeKeyedCollection)

使用协定和服务说明创建和初始化服务主机。

InitializeRuntime()

初始化服务主机的运行时。

LoadConfigurationSection(ServiceElement)

从托管服务的配置文件加载服务元素。

MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
OnAbort()

中止服务。

OnBeginClose(TimeSpan, AsyncCallback, Object)

开始在服务主机关闭时调用的异步操作。

OnBeginOpen(TimeSpan, AsyncCallback, Object)

开始在打开服务主机时调用的异步操作。

OnClose(TimeSpan)

关闭托管服务,包括其通道调度程序和关联的实例上下文和侦听器。

OnClosed()

释放服务主机使用的资源。

OnClosed()

在将通信对象转换为结束状态期间调用。

(继承自 CommunicationObject)
OnClosing()

在将通信对象转换为结束状态期间调用。

(继承自 CommunicationObject)
OnEndClose(IAsyncResult)

完成在服务主机关闭时调用的异步操作。

OnEndOpen(IAsyncResult)

完成在打开服务主机时调用的异步操作。

OnFaulted()

在通信对象由于调用同步故障操作而转换为错误状态后,在通信对象上插入处理。

(继承自 CommunicationObject)
OnOpen(TimeSpan)

打开通道调度程序。

OnOpened()

获取托管服务的服务凭据、服务身份验证和授权行为。

OnOpening()

在将通信对象转换为打开状态期间调用。

(继承自 CommunicationObject)
Open()

使通信对象从创建的状态转换为打开状态。

(继承自 CommunicationObject)
Open(TimeSpan)

使通信对象在指定的时间间隔内从创建的状态转换为打开状态。

(继承自 CommunicationObject)
ReleasePerformanceCounters()

释放托管服务的服务和通道调度程序性能计数器。

SetEndpointAddress(ServiceEndpoint, String)

将指定终结点的终结点地址设置为指定地址。

ThrowIfDisposed()

如果释放通信对象,则引发异常。

(继承自 CommunicationObject)
ThrowIfDisposedOrImmutable()

如果未将属性设置为State状态的通信对象Created,则引发异常。

(继承自 CommunicationObject)
ThrowIfDisposedOrNotOpen()

如果通信对象未处于 Opened 状态,则引发异常。

(继承自 CommunicationObject)
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)

活动

名称 说明
Closed

当通信对象转换为关闭状态时发生。

(继承自 CommunicationObject)
Closing

当通信对象转换为结束状态时发生。

(继承自 CommunicationObject)
Faulted

当通信对象转换为错误状态时发生。

(继承自 CommunicationObject)
Opened

当通信对象转换为打开状态时发生。

(继承自 CommunicationObject)
Opening

当通信对象转换为打开状态时发生。

(继承自 CommunicationObject)
UnknownMessageReceived

收到未知消息时发生。

显式接口实现

名称 说明
IDisposable.Dispose()

关闭服务主机。

适用于