DataServiceHost 类

定义

重要

此 API 不符合 CLS。

派生自 WebServiceHost 的 WCF Data Service 类用于实例化数据服务。The WCF Data Services class derived from WebServiceHost used to instantiate data services.

public ref class DataServiceHost : System::ServiceModel::Web::WebServiceHost
[System.CLSCompliant(false)]
public class DataServiceHost : System.ServiceModel.Web.WebServiceHost
[<System.CLSCompliant(false)>]
type DataServiceHost = class
    inherit WebServiceHost
Public Class DataServiceHost
Inherits WebServiceHost
继承
属性

注解

WCF Data Services 不是自治服务器实体。WCF Data Services are not autonomous server entities. 相反,该服务是托管在环境中的组件(如 Windows Communication Foundation (WCF) ,它提供核心服务器网络功能。Instead, the service is a component hosted in an environment such as the Windows Communication Foundation (WCF) that provides core server networking facilities. 具体而言,服务不会绑定到网络套接字并侦听传入请求到其具象状态传输 (REST) 入口点。Specifically, a service does not bind to and listen on a network socket for incoming requests to its Representational State Transfer (REST) entry points. 宿主将处理与网络的直接交互并支持缓存、可伸缩性和身份验证模块。The host handles direct interactions with the network and support caching, scalability, and authentication modules.

WCF Data Services 定义一个通用宿主接口 IDataServiceHost ,该接口从特定的宿主提取其实现。WCF Data Services defines a generic hosting interface IDataServiceHost that abstracts its implementation from a specific host. 这允许 WCF Data Services 在一系列宿主环境中运行。This allows WCF Data Services to run in a range of hosting environments. 有关详细信息,请参阅 承载数据服务For more information, see Hosting the Data Service.

构造函数

DataServiceHost(Type, Uri[])

实例化 DataServiceHost WCF Data Services。Instantiates DataServiceHost for WCF Data Services.

属性

Authentication

获取服务身份验证行为。Gets the service authentication behavior.

(继承自 ServiceHostBase)
Authorization

获取所承载服务的授权行为。Gets the authorization behavior for the service hosted.

(继承自 ServiceHostBase)
BaseAddresses

获取所承载服务使用的基址。Gets the base addresses used by the hosted service.

(继承自 ServiceHostBase)
ChannelDispatchers

获取服务主机所使用的通道调度程序的集合。Gets the collection of channel dispatchers used by the service host.

(继承自 ServiceHostBase)
CloseTimeout

获取或设置允许服务主机关闭的时间间隔。Gets or sets the interval of time allowed for the service host to close.

(继承自 ServiceHostBase)
Credentials

获取所承载服务的凭据。Gets the credential for the service hosted.

(继承自 ServiceHostBase)
DefaultCloseTimeout

获取允许服务主机关闭的默认时间间隔。Gets the default interval of time allowed for the service host to close.

(继承自 ServiceHostBase)
DefaultOpenTimeout

获取允许服务主机打开的默认时间间隔。Gets the default interval of time allowed for the service host to open.

(继承自 ServiceHostBase)
Description

获取所承载服务的说明。Gets the description of the service hosted.

(继承自 ServiceHostBase)
Extensions

获取当前指定的服务主机的扩展。Gets the extensions for the current specified service host.

(继承自 ServiceHostBase)
ImplementedContracts

检索由所承载服务实现的协定。Retrieves the contracts implemented by the service hosted.

(继承自 ServiceHostBase)
IsDisposed

获取一个值,该值指示通信对象是否已被释放。Gets a value that indicates whether the communication object has been disposed.

(继承自 CommunicationObject)
ManualFlowControlLimit

获取或设置由所承载服务接收的消息的流控制限制。Gets or sets the flow control limit for messages received by the service hosted.

(继承自 ServiceHostBase)
OpenTimeout

获取或设置允许服务主机打开的时间间隔。Gets or sets the interval of time allowed for the service host to open.

(继承自 ServiceHostBase)
SingletonInstance

获取承载服务的单一实例。Gets the singleton instance of the hosted service.

(继承自 ServiceHost)
State

获取指示通信对象当前状态的值。Gets a value that indicates the current state of the communication object.

(继承自 CommunicationObject)
ThisLock

获取在状态转换过程中保护类实例的相互排斥锁。Gets the mutually exclusive lock that protects the class instance during a state transition.

(继承自 CommunicationObject)

方法

Abort()

使通信对象立即从其当前状态转换到正在关闭状态。Causes a communication object to transition immediately from its current state into the closing state.

(继承自 CommunicationObject)
AddBaseAddress(Uri)

将基址添加到服务主机。Adds a base address to the service host.

(继承自 ServiceHostBase)
AddDefaultEndpoints()

使用默认绑定为在服务主机中找到的每个协定中的所有基址添加服务终结点。Adds service endpoints for all base addresses in each contract found in the service host with the default binding.

(继承自 ServiceHostBase)
AddServiceEndpoint(ServiceEndpoint)

将指定的服务终结点添加到承载服务中。Adds the specified service endpoint to the hosted service.

(继承自 ServiceHostBase)
AddServiceEndpoint(String, Binding, String)

使用指定的协定、绑定和终结点地址将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

(继承自 ServiceHostBase)
AddServiceEndpoint(String, Binding, String, Uri)

使用指定的协定、绑定和终结点地址以及包含服务所侦听地址的 URI,将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, endpoint address and URI that contains the address at which it listens.

(继承自 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri)

使用指定的协定、绑定和包含终结点地址的 URI 将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, and a URI that contains the endpoint address.

(继承自 ServiceHostBase)
AddServiceEndpoint(String, Binding, Uri, Uri)

使用指定的协定、绑定和包含终结点与所侦听地址的 URI,将服务终结点添加到承载服务。Adds a service endpoint to the hosted service with the specified contract, binding, and URIs that contain the endpoint and listening addresses.

(继承自 ServiceHostBase)
AddServiceEndpoint(Type, Binding, String)

使用指定的协定、绑定和终结点地址将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

(继承自 ServiceHost)
AddServiceEndpoint(Type, Binding, String, Uri)

使用指定的协定、绑定和终结点地址以及服务在其上侦听的 URI 将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, an endpoint address, and a URI on which the service listens.

(继承自 ServiceHost)
AddServiceEndpoint(Type, Binding, Uri)

使用指定的协定、绑定和包含终结点地址的 URI 将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, and URI that contains the endpoint address.

(继承自 ServiceHost)
AddServiceEndpoint(Type, Binding, Uri, Uri)

使用指定的协定、绑定、包含终结点地址的 URI 以及服务在其上侦听的 URI 将服务终结点添加到承载服务中。Adds a service endpoint to the hosted service with a specified contract, binding, a URI that contains the endpoint address, and a URI on which the service listens.

(继承自 ServiceHost)
ApplyConfiguration()

从配置文件加载服务说明,并将其应用于正在构造的运行库。Loads the service description from the configuration file and applies it to the runtime being constructed.

(继承自 ServiceHost)
BeginClose(AsyncCallback, Object)

开始一个异步操作以关闭通信对象。Begins an asynchronous operation to close a communication object.

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

开始一个异步操作以在指定超时内关闭通信对象。Begins an asynchronous operation to close a communication object with a specified timeout.

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

开始一个异步操作以打开通信对象。Begins an asynchronous operation to open a communication object.

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

开始一个异步操作以在指定时间间隔内打开通信对象。Begins an asynchronous operation to open a communication object within a specified interval of time.

(继承自 CommunicationObject)
Close()

使通信对象从其当前状态转换到关闭状态。Causes a communication object to transition from its current state into the closed state.

(继承自 CommunicationObject)
Close(TimeSpan)

使通信对象在指定时间间隔内从当前状态转换到关闭状态。Causes a communication object to transition from its current state into the closed state within a specified interval of time.

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

创建承载服务的说明。Creates a description of the service hosted.

(继承自 ServiceHost)
EndClose(IAsyncResult)

完成一个异步操作以关闭通信对象。Completes an asynchronous operation to close a communication object.

(继承自 CommunicationObject)
EndOpen(IAsyncResult)

完成一个异步操作以打开通信对象。Completes an asynchronous operation to open a communication object.

(继承自 CommunicationObject)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
Fault()

使通信对象从其当前状态转换到出错状态。Causes a communication object to transition from its current state into the faulted state.

(继承自 CommunicationObject)
GetCommunicationObjectType()

获取通信对象的类型。Gets the type of communication object.

(继承自 CommunicationObject)
GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
IncrementManualFlowControlLimit(Int32)

以指定的增量增加对消息到所承载服务的流入率的限制。Increases the limit on the flow rate of messages to the hosted service by a specified increment.

(继承自 ServiceHostBase)
InitializeDescription(Object, UriSchemeKeyedCollection)

基于承载服务的实例和指定的基址初始化该承载服务的说明。Initializes a description of the service hosted based on its instance and specified base addresses.

(继承自 ServiceHost)
InitializeDescription(Type, UriSchemeKeyedCollection)

基于承载服务的类型和指定的基址初始化该承载服务的说明。Initializes a description of the service hosted based on its type and specified base addresses.

(继承自 ServiceHost)
InitializeDescription(UriSchemeKeyedCollection)

使用协定和服务说明创建并初始化服务主机。Creates and initializes the service host with the contract and service descriptions.

(继承自 ServiceHostBase)
InitializeRuntime()

初始化服务主机的运行库。Initializes the runtime for the service host.

(继承自 ServiceHostBase)
LoadConfigurationSection(ServiceElement)

从承载服务的配置文件加载服务元素。Loads the service element from the configuration file of the hosted service.

(继承自 ServiceHostBase)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
OnAbort()

中止服务。Aborts the service.

(继承自 ServiceHostBase)
OnBeginClose(TimeSpan, AsyncCallback, Object)

开始在关闭服务主机时调用的异步操作。Begins an asynchronous operation invoked on the close of the service host.

(继承自 ServiceHostBase)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

开始在打开服务主机时调用的异步操作。Begins an asynchronous operation invoked on the opening of the service host.

(继承自 ServiceHostBase)
OnClose(TimeSpan)

关闭所承载服务,包括它们的通道调度程序以及相关的实例上下文和侦听器。Closes down the hosted service, including their channel dispatchers and associated instance contexts and listeners.

(继承自 ServiceHostBase)
OnClosed()

当服务主机关闭时,释放所承载的可处置服务。Disposes of disposable services that are being hosted when the service host is closed.

(继承自 ServiceHost)
OnClosing()

在通信对象转换到正在关闭状态的过程中被调用。Invoked during the transition of a communication object into the closing state.

(继承自 CommunicationObject)
OnEndClose(IAsyncResult)

完成在关闭服务主机时调用的异步操作。Completes an asynchronous operation invoked on the closing of the service host.

(继承自 ServiceHostBase)
OnEndOpen(IAsyncResult)

完成在打开服务主机时调用的异步操作。Completes an asynchronous operation invoked on the opening of the service host.

(继承自 ServiceHostBase)
OnFaulted()

在调用了同步错误操作,从而引起通信对象转换为出错状态的情况下,该方法插入对通信对象的处理。Inserts processing on a communication object after it transitions to the faulted state due to the invocation of a synchronous fault operation.

(继承自 CommunicationObject)
OnOpen(TimeSpan)

打开通道调度程序。Opens the channel dispatchers.

(继承自 ServiceHostBase)
OnOpened()

获取所承载服务的服务凭据、服务身份验证和授权行为。Gets the service credentials,service authentication and authorization behavior for the hosted service.

(继承自 ServiceHostBase)
OnOpening()

WebServiceHost 实例打开时调用。Called when the WebServiceHost instance opens.

(继承自 WebServiceHost)
Open()

使通信对象从已创建状态转换到已打开状态。Causes a communication object to transition from the created state into the opened state.

(继承自 CommunicationObject)
Open(TimeSpan)

使通信对象在指定时间间隔内从已创建状态转换到已打开状态。Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(继承自 CommunicationObject)
ReleasePerformanceCounters()

释放所承载服务的服务与通道调度程序性能计数器。Releases the service and channel dispatcher performance counters for the hosted service.

(继承自 ServiceHostBase)
SetEndpointAddress(ServiceEndpoint, String)

将指定终结点的终结点地址设置为指定的地址。Sets the endpoint address of the specified endpoint to the specified address.

(继承自 ServiceHostBase)
ThrowIfDisposed()

如果通信对象已释放,则引发异常。Throws an exception if the communication object is disposed.

(继承自 CommunicationObject)
ThrowIfDisposedOrImmutable()

如果通信对象的 State 属性未设置为 Created 状态,则引发异常。Throws an exception if the communication object the State property is not set to the Created state.

(继承自 CommunicationObject)
ThrowIfDisposedOrNotOpen()

如果通信对象未处于 Opened 状态,则引发异常。Throws an exception if the communication object is not in the Opened state.

(继承自 CommunicationObject)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)

事件

Closed

当通信对象转换到已关闭状态时发生。Occurs when a communication object transitions into the closed state.

(继承自 CommunicationObject)
Closing

当通信对象转换到正在关闭状态时发生。Occurs when a communication object transitions into the closing state.

(继承自 CommunicationObject)
Faulted

在通信对象转换到出错状态时发生。Occurs when a communication object transitions into the faulted state.

(继承自 CommunicationObject)
Opened

当通信对象转换到已打开状态时发生。Occurs when a communication object transitions into the opened state.

(继承自 CommunicationObject)
Opening

当通信对象转换到正在打开状态时发生。Occurs when a communication object transitions into the opening state.

(继承自 CommunicationObject)
UnknownMessageReceived

接收未知消息时发生。Occurs when an unknown message is received.

(继承自 ServiceHostBase)

显式接口实现

IDisposable.Dispose()

关闭服务主机。Closes the service host.

(继承自 ServiceHostBase)

适用于