ServiceHostBase 类

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.dll

扩展 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)

继承

Object

CommunicationObject

ServiceHostBase

派生

System.ServiceModel.Activities.WorkflowServiceHost

System.ServiceModel.ServiceHost

System.ServiceModel.WorkflowServiceHost

实现

IDisposable IExtensibleObject<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)

方法

Abort()	使通信对象立即从其当前状态转换到正在关闭状态。 (继承自 CommunicationObject)
AddBaseAddress(Uri)	将基址添加到服务主机。
AddDefaultEndpoints()	使用默认绑定为在服务主机中找到的每个协定中的所有基址添加服务终结点。
AddServiceEndpoint(ServiceEndpoint)	将指定的服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, String)	使用指定的协定、绑定和终结点地址将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, String, Uri)	使用指定的协定、绑定和终结点地址以及包含服务所侦听地址的 URI，将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, Uri)	使用指定的协定、绑定和包含终结点地址的 URI 将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, Uri, 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)	关闭所承载服务，包括它们的通道调度程序以及相关的实例上下文和侦听器。
OnCloseAsync(TimeSpan)	扩展 ServiceHostBase 类，以实现可公开自定义编程模型的主机。 (继承自 CommunicationObject)
OnClosed()	释放服务主机占用的资源。
OnClosing()	在通信对象转换到正在关闭状态的过程中被调用。 (继承自 CommunicationObject)
OnEndClose(IAsyncResult)	完成在关闭服务主机时调用的异步操作。
OnEndOpen(IAsyncResult)	完成在打开服务主机时调用的异步操作。
OnFaulted()	在调用了同步错误操作，从而引起通信对象转换为出错状态的情况下，该方法插入对通信对象的处理。 (继承自 CommunicationObject)
OnOpen(TimeSpan)	打开通道调度程序。
OnOpenAsync(TimeSpan)	扩展 ServiceHostBase 类，以实现可公开自定义编程模型的主机。 (继承自 CommunicationObject)
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()

关闭服务主机。