ServiceHostBase.AddServiceEndpoint Метод

Определение

Добавляет конечные точки службы в размещенную службу.Adds the service endpoints to the service hosted.

Перегрузки

AddServiceEndpoint(ServiceEndpoint)

Добавляет заданную конечную точку службы в размещенную службу.Adds the specified service endpoint to the hosted service.

AddServiceEndpoint(String, Binding, String)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой и адресом конечной точки.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

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.

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.

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.

AddServiceEndpoint(ServiceEndpoint)

Добавляет заданную конечную точку службы в размещенную службу.Adds the specified service endpoint to the hosted service.

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

Конечная точка службы.The service endpoint.

Исключения

Свойство Endpoint имеет значение null.Endpoint is null.

Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы.The host is not in a Created or an Opening state or there is no ServiceDescription for the hosted service.

Значение Address, Binding или Contract равно null.The Address, Binding, or Contract property is null.

Комментарии

При использовании метода узел службы выполняет проверку в описании контракта на "by-Configuration-Name".When using the method, the service host does a "by-configuration-name" validation on the contract description. Иными словами, узел проверяет ConfigurationName существование в списке имен конфигураций контрактов служб, реализованных службой.In other words, the host verifies that ConfigurationName exists in the list of configuration names of the service contracts implemented by the service. Если проверка пройдена, в используется описание в ServiceEndpoint , даже если значение ContractDescription , отраженное в службе, отличается.If the validation passes, the description in the ServiceEndpoint is used as it is, even if the ContractDescription reflected from the service is different.

В качестве примера предположим, что описание в ServiceEndpoint и описание контракта, отраженное от службы, имеют одинаковое имя, но разные поведения операций.As an example, assume that the description in the ServiceEndpoint and the contract description reflected from the service have the same name, but different operation behaviors. Следствием только проверки «by-Configuration-Name» является отсутствие проверки подлинности и наличие одного обновления в одном описании из-за другого описания.The implication of only "by-configuration-name" validation is that there is no validation that the behaviors are the same and there are one updates to one description because of another description.

Если параметр address является относительным универсальным кодом ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If the address is a relative URI, one of the base addresses of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

AddServiceEndpoint(String, Binding, String)

Добавляет конечную точку службы в размещенную службу с указанными контрактом, привязкой и адресом конечной точки.Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.

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

Параметры

implementedContract
String

Контракт, реализованный конечной точкой.The contract implemented by the endpoint.

binding
Binding

Привязка Binding для добавленной конечной точки.The Binding for the endpoint added.

address
String

Адрес для добавленной конечной точки.The address for the endpoint added. Он может представлять собой как абсолютный, так и относительный универсальный код ресурса (URI).This can be an absolute or relative URI. Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If it is a relative URI, one of the base address of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

Возвраты

Объект ServiceEndpoint, добавленный в размещенную службу.The ServiceEndpoint added to the hosted service.

Исключения

Значение параметра implementedContract, или параметра binding, или параметра addressnull.implementedContract or binding or address or is null.

Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы, поэтому невозможно добавить конечную точку или в привязке отсутствует транспорт схемы привязки.The host is not in a Created or an Opening state or there is no ServiceDescription for the hosted service and so an endpoint cannot be added or the binding lacks a transport of binding scheme.

Примеры

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

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.

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

Параметры

implementedContract
String

Контракт, реализованный конечной точкой.The contract implemented by the endpoint.

binding
Binding

Привязка Binding для добавленной конечной точки.The Binding for the endpoint added.

address
Uri

Код Uri, содержащий адрес для добавленной конечной точки.The Uri that contains the address for the endpoint added. Он может представлять собой как абсолютный, так и относительный универсальный код ресурса (URI).This can be an absolute or relative URI. Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If it is a relative URI, one of the base address of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

Возвраты

Объект ServiceEndpoint, добавленный в размещенную службу.The ServiceEndpoint added to the hosted service.

Исключения

Значение параметра implementedContract, или параметра binding, или параметра addressnull.implementedContract or binding or address or is null.

Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы, поэтому невозможно добавить конечную точку.The host is not in a Created or an Opening state or there is no ServiceDescription for the hosted service and so an endpoint cannot be added.

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.

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

Параметры

implementedContract
String

Контракт, реализованный конечной точкой.The contract implemented by the endpoint.

binding
Binding

Привязка Binding для добавленной конечной точки.The Binding for the endpoint added.

address
String

Адрес для добавленной конечной точки.The address for the endpoint added. Этот адрес может быть как абсолютным, так и относительным универсальным кодом ресурса (URI).This address can be an absolute or relative URI. Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If it is a relative URI, one of the base address of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

listenUri
Uri

Объект Uri, содержащий адрес, по которому конечная точка прослушивает входящие сообщения.The Uri that contains the address which the endpoint listens to for incoming messages. URI может быть относительным или абсолютным.This URI can be relative or absolute.

Возвраты

Объект ServiceEndpoint, добавленный в размещенную службу.The ServiceEndpoint added to the hosted service.

Исключения

Значение параметра implementedContract, или параметра binding, или параметра addressnull.implementedContract or binding or address or is null.

Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы, поэтому невозможно добавить конечную точку.The host is not in a Created or an Opening state or there is no ServiceDescription for the hosted service and so an endpoint cannot be added.

Комментарии

Если параметр address является относительным универсальным кодом ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If the address is a relative URI, one of the base addresses of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

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.

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

Параметры

implementedContract
String

Контракт, реализованный конечной точкой.The contract implemented by the endpoint.

binding
Binding

Привязка Binding для добавленной конечной точки.The Binding for the endpoint added.

address
Uri

Код Uri, содержащий адрес для добавленной конечной точки.The Uri that contains the address for the endpoint added. Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.If it is a relative URI, one of the base address of the ServiceHost (depending on the binding protocol) is used as the endpoint's base address.

listenUri
Uri

Объект Uri, содержащий адрес, по которому конечная точка прослушивает входящие сообщения.The Uri that contains the address at which the endpoint listens for incoming messages.

Возвраты

Объект ServiceEndpoint, добавленный в размещенную службу.The ServiceEndpoint added to the hosted service. URI может быть относительным или абсолютным.This URI can be absolute or relative.

Исключения

Значение параметра implementedContract, или параметра binding, или параметра addressnull.implementedContract or binding or address or is null.

Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы, поэтому невозможно добавить конечную точку.The host is not in a Created or an Opening state or there is no ServiceDescription for the hosted service and so an endpoint cannot be added.

Применяется к