ServiceHostBase.AddServiceEndpoint Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет конечные точки службы в размещенную службу.
Перегрузки
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
Конечная точка службы.
Исключения
Endpoint
имеет значение null
.
Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы.
Значение 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
Контракт, реализованный конечной точкой.
- address
- String
Адрес для добавленной конечной точки. Он может представлять собой как абсолютный, так и относительный универсальный код ресурса (URI). Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.
Возвращаемое значение
Объект ServiceEndpoint, добавленный в размещенную службу.
Исключения
Значение параметра implementedContract
, или параметра binding
, или параметра address
— null
.
Узел не находится в состоянии 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
Контракт, реализованный конечной точкой.
- address
- Uri
Код Uri, содержащий адрес для добавленной конечной точки. Он может представлять собой как абсолютный, так и относительный универсальный код ресурса (URI). Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.
Возвращаемое значение
Объект ServiceEndpoint, добавленный в размещенную службу.
Исключения
Значение параметра implementedContract
, или параметра binding
, или параметра address
— null
.
Узел не находится в состоянии 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
Контракт, реализованный конечной точкой.
- address
- String
Адрес для добавленной конечной точки. Этот адрес может быть как абсолютным, так и относительным универсальным кодом ресурса (URI). Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.
- listenUri
- Uri
Объект Uri, содержащий адрес, по которому конечная точка прослушивает входящие сообщения. URI может быть относительным или абсолютным.
Возвращаемое значение
Объект ServiceEndpoint, добавленный в размещенную службу.
Исключения
Значение параметра implementedContract
, или параметра binding
, или параметра address
— null
.
Узел не находится в состоянии 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
Контракт, реализованный конечной точкой.
- address
- Uri
Код Uri, содержащий адрес для добавленной конечной точки. Если он представляет собой относительный универсальный код ресурса (URI), один из базовых адресов ServiceHost (в зависимости от протокола привязки) используется в качестве базового адреса конечной точки.
- listenUri
- Uri
Объект Uri, содержащий адрес, по которому конечная точка прослушивает входящие сообщения.
Возвращаемое значение
Объект ServiceEndpoint, добавленный в размещенную службу. URI может быть относительным или абсолютным.
Исключения
Значение параметра implementedContract
, или параметра binding
, или параметра address
— null
.
Узел не находится в состоянии Created или Opening либо отсутствует описание ServiceDescription размещенной службы, поэтому невозможно добавить конечную точку.