ServiceHostBase.AddServiceEndpoint Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.dll

Dodaje punkty końcowe usługi do hostowanej usługi.

Przeciążenia

AddServiceEndpoint(ServiceEndpoint)	Dodaje określony punkt końcowy usługi do hostowanej usługi.
AddServiceEndpoint(String, Binding, String)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i adresem punktu końcowego.
AddServiceEndpoint(String, Binding, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorem URI zawierającym adres punktu końcowego.
AddServiceEndpoint(String, Binding, String, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem, adresem punktu końcowego i identyfikatorem URI zawierającym adres, pod którym nasłuchuje.
AddServiceEndpoint(String, Binding, Uri, Uri)	Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorami URI, które zawierają punkt końcowy i adresy nasłuchiwania.

AddServiceEndpoint(ServiceEndpoint)

Dodaje określony punkt końcowy usługi do hostowanej usługi.

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)

Parametry

endpoint

ServiceEndpoint

Punkt końcowy usługi.

Wyjątki

ArgumentNullException

Endpoint to null.

InvalidOperationException

Host nie znajduje się w stanie Utworzono lub Otwarcie albo nie ServiceDescription istnieje dla hostowanej usługi.

ArgumentException

Właściwość Address, Bindinglub Contract ma wartość null.

Uwagi

W przypadku korzystania z metody host usługi wykonuje weryfikację "by-configuration-name" w opisie kontraktu. Innymi słowy host sprawdza, czy ConfigurationName istnieje na liście nazw konfiguracji kontraktów usług implementowanych przez usługę. Jeśli walidacja przebiegnie pomyślnie, opis w obiekcie ServiceEndpoint jest używany tak, jak jest, nawet jeśli ContractDescription odzwierciedlone z usługi jest inny.

Załóżmy na przykład, że opis w punkcie ServiceEndpoint i opis kontraktu odzwierciedlony w usłudze mają taką samą nazwę, ale różne zachowania operacji. Implikacja tylko weryfikacji "by-configuration-name" polega na tym, że nie ma walidacji, że zachowania są takie same i istnieje jedna aktualizacja jednego opisu z powodu innego opisu.

Jeśli parametr address jest względnym identyfikatorem URI, jeden z adresów ServiceHost podstawowych (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

AddServiceEndpoint(String, Binding, String)

Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i adresem punktu końcowego.

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

Parametry

implementedContract

String

Kontrakt zaimplementowany przez punkt końcowy.

binding

Binding

Element Binding dla dodanego punktu końcowego.

address

String

Adres dodanego punktu końcowego. Może to być bezwzględny lub względny identyfikator URI. Jeśli jest to względny identyfikator URI, jeden z podstawowych adresów ServiceHost (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

Zwraca

ServiceEndpoint

Element ServiceEndpoint dodany do usługi hostowanej.

Wyjątki

ArgumentNullException

implementedContract lub binding address lub ma wartość null.

InvalidOperationException

Host nie znajduje się w Created stanie lub Opening nie ServiceDescription istnieje dla hostowanej usługi i dlatego nie można dodać punktu końcowego lub powiązanie nie ma transportu schematu powiązań.

Przykłady

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

AddServiceEndpoint(String, Binding, Uri)

Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorem URI zawierającym adres punktu końcowego.

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

Parametry

implementedContract

String

Kontrakt zaimplementowany przez punkt końcowy.

binding

Binding

Element Binding dla dodanego punktu końcowego.

address

Uri

Element Uri zawierający adres dodanego punktu końcowego. Może to być bezwzględny lub względny identyfikator URI. Jeśli jest to względny identyfikator URI, jeden z podstawowych adresów ServiceHost (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

Zwraca

ServiceEndpoint

Element ServiceEndpoint dodany do usługi hostowanej.

Wyjątki

ArgumentNullException

implementedContract lub binding address lub ma wartość null.

InvalidOperationException

Host nie znajduje się w Created stanie lub Opening nie ServiceDescription istnieje dla hostowanej usługi i dlatego nie można dodać punktu końcowego.

AddServiceEndpoint(String, Binding, String, Uri)

Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem, adresem punktu końcowego i identyfikatorem URI zawierającym adres, pod którym nasłuchuje.

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

Parametry

implementedContract

String

Kontrakt zaimplementowany przez punkt końcowy.

binding

Binding

Element Binding dla dodanego punktu końcowego.

address

String

Adres dodanego punktu końcowego. Ten adres może być bezwzględnym lub względnym identyfikatorem URI. Jeśli jest to względny identyfikator URI, jeden z podstawowych adresów ServiceHost (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

listenUri

Uri

Element Uri zawierający adres, z którym punkt końcowy nasłuchuje komunikatów przychodzących. Ten identyfikator URI może być względny lub bezwzględny.

Zwraca

ServiceEndpoint

Element ServiceEndpoint dodany do usługi hostowanej.

Wyjątki

ArgumentNullException

implementedContract lub binding address lub ma wartość null.

InvalidOperationException

Host nie znajduje się w Created stanie lub Opening nie ServiceDescription istnieje dla hostowanej usługi i dlatego nie można dodać punktu końcowego.

Uwagi

Jeśli parametr address jest względnym identyfikatorem URI, jeden z adresów ServiceHost podstawowych (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

AddServiceEndpoint(String, Binding, Uri, Uri)

Dodaje punkt końcowy usługi do hostowanej usługi z określonym kontraktem, powiązaniem i identyfikatorami URI, które zawierają punkt końcowy i adresy nasłuchiwania.

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

Parametry

implementedContract

String

Kontrakt zaimplementowany przez punkt końcowy.

binding

Binding

Element Binding dla dodanego punktu końcowego.

address

Uri

Element Uri zawierający adres dodanego punktu końcowego. Jeśli jest to względny identyfikator URI, jeden z podstawowych adresów ServiceHost (w zależności od protokołu powiązania) jest używany jako adres podstawowy punktu końcowego.

listenUri

Uri

Zawiera Uri adres, pod którym punkt końcowy nasłuchuje komunikatów przychodzących.

Zwraca

ServiceEndpoint

Element ServiceEndpoint dodany do usługi hostowanej. Ten identyfikator URI może być bezwzględny lub względny.

Wyjątki

ArgumentNullException

implementedContract lub binding address lub ma wartość null.

InvalidOperationException

Host nie znajduje się w Created stanie lub Opening nie ServiceDescription istnieje dla hostowanej usługi i dlatego nie można dodać punktu końcowego.