ServiceHostBase.AddServiceEndpoint 方法

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.dll

将服务终结点添加到承载服务中。

重载

AddServiceEndpoint(ServiceEndpoint)	将指定的服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, String)	使用指定的协定、绑定和终结点地址将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, Uri)	使用指定的协定、绑定和包含终结点地址的 URI 将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, String, Uri)	使用指定的协定、绑定和终结点地址以及包含服务所侦听地址的 URI，将服务终结点添加到承载服务中。
AddServiceEndpoint(String, Binding, Uri, Uri)	使用指定的协定、绑定和包含终结点与所侦听地址的 URI，将服务终结点添加到承载服务。

AddServiceEndpoint(ServiceEndpoint)

将指定的服务终结点添加到承载服务中。

public:
 virtual void AddServiceEndpoint(System::ServiceModel::Description::ServiceEndpoint ^ endpoint);

public virtual void AddServiceEndpoint (System.ServiceModel.Description.ServiceEndpoint endpoint);

abstract member AddServiceEndpoint : System.ServiceModel.Description.ServiceEndpoint -> unit
override this.AddServiceEndpoint : System.ServiceModel.Description.ServiceEndpoint -> unit

Public Overridable Sub AddServiceEndpoint (endpoint As ServiceEndpoint)

参数

endpoint

ServiceEndpoint

服务终结点。

例外

ArgumentNullException

Endpoint 为 null。

InvalidOperationException

主机未处于已创建或打开状态，或者所承载服务没有 ServiceDescription。

ArgumentException

Address、Binding 或 Contract 属性为 null。

注解

使用 方法时，服务主机对协定说明执行“按配置名称”验证。 换句话说，主机验证 ConfigurationName 是否存在于服务实现的服务协定的配置名称列表中。 如果验证通过，则 中的 ServiceEndpoint 说明将按原样使用，即使 ContractDescription 从服务反映的 是不同的。

例如，假设 ServiceEndpoint 中的说明和服务反映的协定说明具有相同的名称，但操作行为不同。 仅“按配置名称”验证的含义是，无法验证行为是否相同，并且由于另一个说明而对一个说明有一个更新。

address如果 是相对 URI，则根据绑定协议) 使用 (的基址ServiceHost之一作为终结点的基址。

AddServiceEndpoint(String, Binding, String)

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

public:
 System::ServiceModel::Description::ServiceEndpoint ^ AddServiceEndpoint(System::String ^ implementedContract, System::ServiceModel::Channels::Binding ^ binding, System::String ^ address);

public System.ServiceModel.Description.ServiceEndpoint AddServiceEndpoint (string implementedContract, System.ServiceModel.Channels.Binding binding, string address);

member this.AddServiceEndpoint : string * System.ServiceModel.Channels.Binding * string -> System.ServiceModel.Description.ServiceEndpoint

Public Function AddServiceEndpoint (implementedContract As String, binding As Binding, address As String) As ServiceEndpoint

参数

implementedContract

String

终结点实现的协定。

binding

Binding

所添加终结点的 Binding。

address

String

所添加终结点的地址。 这可以是绝对 URI，也可以是相对 URI。 如果是相对的 URI，则 ServiceHost 的其中一个基址（取决于绑定协议）会用作终结点的基址。

返回

ServiceEndpoint

添加到承载服务中的 ServiceEndpoint。

例外

ArgumentNullException

implementedContract 或 binding 或 address 或为 null。

InvalidOperationException

主机未处于 Created 或 Opening 状态，或者所承载服务没有 ServiceDescription，因此无法添加终结点，或绑定缺少绑定方案的传输。

示例

  NetTcpBinding portsharingBinding = new NetTcpBinding();
  hostDefault.AddServiceEndpoint(
typeof(CalculatorService),
portsharingBinding,
"net.tcp://localhost/MyService");

AddServiceEndpoint(String, Binding, Uri)

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

public:
 System::ServiceModel::Description::ServiceEndpoint ^ AddServiceEndpoint(System::String ^ implementedContract, System::ServiceModel::Channels::Binding ^ binding, Uri ^ address);

public System.ServiceModel.Description.ServiceEndpoint AddServiceEndpoint (string implementedContract, System.ServiceModel.Channels.Binding binding, Uri address);

member this.AddServiceEndpoint : string * System.ServiceModel.Channels.Binding * Uri -> System.ServiceModel.Description.ServiceEndpoint

Public Function AddServiceEndpoint (implementedContract As String, binding As Binding, address As Uri) As ServiceEndpoint

参数

implementedContract

String

终结点实现的协定。

binding

Binding

所添加终结点的 Binding。

address

Uri

包含所添加终结点地址的 Uri。 这可以是绝对 URI，也可以是相对 URI。 如果是相对的 URI，则 ServiceHost 的其中一个基址（取决于绑定协议）会用作终结点的基址。

返回

ServiceEndpoint

添加到承载服务中的 ServiceEndpoint。

例外

ArgumentNullException

implementedContract 或 binding 或 address 或为 null。

InvalidOperationException

主机未处于 Created 或 Opening 状态，或者所承载服务没有 ServiceDescription，因此无法添加终结点。

AddServiceEndpoint(String, Binding, String, Uri)

使用指定的协定、绑定和终结点地址以及包含服务所侦听地址的 URI，将服务终结点添加到承载服务中。

public:
 System::ServiceModel::Description::ServiceEndpoint ^ AddServiceEndpoint(System::String ^ implementedContract, System::ServiceModel::Channels::Binding ^ binding, System::String ^ address, Uri ^ listenUri);

public System.ServiceModel.Description.ServiceEndpoint AddServiceEndpoint (string implementedContract, System.ServiceModel.Channels.Binding binding, string address, Uri listenUri);

member this.AddServiceEndpoint : string * System.ServiceModel.Channels.Binding * string * Uri -> System.ServiceModel.Description.ServiceEndpoint

Public Function AddServiceEndpoint (implementedContract As String, binding As Binding, address As String, listenUri As Uri) As ServiceEndpoint

参数

implementedContract

String

终结点实现的协定。

binding

Binding

所添加终结点的 Binding。

address

String

所添加终结点的地址。 此地址可以是相对的 URI，也可以是绝对的 URI。 如果是相对的 URI，则 ServiceHost 的其中一个基址（取决于绑定协议）会用作终结点的基址。

listenUri

Uri

Uri，包含终结点在其上侦听传入消息的地址。 该 URI 可以是相对的，也可以是绝对的。

返回

ServiceEndpoint

添加到承载服务中的 ServiceEndpoint。

例外

ArgumentNullException

implementedContract 或 binding 或 address 或为 null。

InvalidOperationException

主机未处于 Created 或 Opening 状态，或者所承载服务没有 ServiceDescription，因此无法添加终结点。

注解

address如果 是相对 URI，则根据绑定协议) 使用 (的基址ServiceHost之一作为终结点的基址。

AddServiceEndpoint(String, Binding, Uri, Uri)

使用指定的协定、绑定和包含终结点与所侦听地址的 URI，将服务终结点添加到承载服务。

public:
 System::ServiceModel::Description::ServiceEndpoint ^ AddServiceEndpoint(System::String ^ implementedContract, System::ServiceModel::Channels::Binding ^ binding, Uri ^ address, Uri ^ listenUri);

public System.ServiceModel.Description.ServiceEndpoint AddServiceEndpoint (string implementedContract, System.ServiceModel.Channels.Binding binding, Uri address, Uri listenUri);

member this.AddServiceEndpoint : string * System.ServiceModel.Channels.Binding * Uri * Uri -> System.ServiceModel.Description.ServiceEndpoint

Public Function AddServiceEndpoint (implementedContract As String, binding As Binding, address As Uri, listenUri As Uri) As ServiceEndpoint

参数

implementedContract

String

终结点实现的协定。

binding

Binding

所添加终结点的 Binding。

address

Uri

包含所添加终结点地址的 Uri。 如果是相对的 URI，则 ServiceHost 的其中一个基址（取决于绑定协议）会用作终结点的基址。

listenUri

Uri

Uri，包含终结点在其上侦听传入消息的地址。

返回

ServiceEndpoint

添加到承载服务中的 ServiceEndpoint。 该 URI 可以是绝对的，也可以是相对的。

例外

ArgumentNullException

implementedContract 或 binding 或 address 或为 null。

InvalidOperationException

主机未处于 Created 或 Opening 状态，或者所承载服务没有 ServiceDescription，因此无法添加终结点。