ServiceHostBase.AddServiceEndpoint Methode

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Fügt dem gehosteten Dienst die Dienstendpunkte hinzu.

Überlädt

AddServiceEndpoint(ServiceEndpoint)	Fügt den angegebenen Dienstendpunkt dem gehosteten Dienst hinzu.
AddServiceEndpoint(String, Binding, String)	Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einer Endpunktadresse hinzu.
AddServiceEndpoint(String, Binding, Uri)	Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einem URI mit der Endpunktadresse hinzu.
AddServiceEndpoint(String, Binding, String, Uri)	Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung, einer Endpunktadresse und einem URI hinzu, der die Adresse enthält, die er überwacht.
AddServiceEndpoint(String, Binding, Uri, Uri)	Fügt dem gehosteten Dienst einen Dienstendpunkt mit dem angegebenen Vertrag, einer Bindung und URIs mit den Endpunkt- und Überwachungsadressen hinzu.

AddServiceEndpoint(ServiceEndpoint)

Fügt den angegebenen Dienstendpunkt dem gehosteten Dienst hinzu.

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)

Parameter

endpoint

ServiceEndpoint

Der Dienstendpunkt.

Ausnahmen

ArgumentNullException

Endpoint ist null.

InvalidOperationException

Dieser Host befindet sich nicht in einem Created-Zustand oder in einem Opening-Zustand, oder es gibt keine ServiceDescription für den gehosteten Dienst.

ArgumentException

Die Eigenschaft Address, Binding oder Contract ist null.

Hinweise

Bei Verwendung der -Methode führt der Diensthost eine Überprüfung nach Konfigurationsname für die Vertragsbeschreibung durch. Anders ausgedrückt: Der Host überprüft, ob ConfigurationName in der Liste der Konfigurationsnamen der vom Dienst implementierten Dienstverträge vorhanden ist. Wenn die Validierung erfolgreich ist, wird die Beschreibung im ServiceEndpoint so verwendet, wie sie ist, auch wenn sich die ContractDescription vom Dienst widergibt.

Angenommen, die Beschreibung im ServiceEndpoint und die Vertragsbeschreibung, die vom Dienst wiedergegeben wird, weisen den gleichen Namen, aber unterschiedliche Vorgangsverhalten auf. Dies hat zur Folge, dass nur die Überprüfung nach Konfigurationsname nicht überprüft wird, dass das Verhalten identisch ist und aufgrund einer anderen Beschreibung eine Aktualisierung an einer Beschreibung vorhanden ist.

Wenn ein address relativer URI ist, wird eine der Basisadressen des ServiceHost (abhängig vom Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

AddServiceEndpoint(String, Binding, String)

Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einer Endpunktadresse hinzu.

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

Parameter

implementedContract

String

Der vom Endpunkt implementierte Vertrag.

binding

Binding

Die Binding-Einstellung für den hinzugefügten Endpunkt.

address

String

Die Adresse für den hinzugefügten Endpunkt. Dies kann ein absoluter oder relativer URI sein. Im Falle eines relativen URI wird eine der Basisadressen von ServiceHost (je nach Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

Gibt zurück

ServiceEndpoint

Der ServiceEndpoint, der dem gehosteten Dienst hinzugefügt wurde.

Ausnahmen

ArgumentNullException

implementedContract oder binding oder address oder ist null.

InvalidOperationException

Dieser Host befindet sich nicht in einem Created-Zustand oder in einem Opening-Zustand, oder es gibt keine ServiceDescription-Einstellung für den gehosteten Dienst, weshalb kein Endpunkt hinzugefügt werden kann oder der Bindung ein Transport des Bindungsschemas fehlt.

Beispiele

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

AddServiceEndpoint(String, Binding, Uri)

Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung und einem URI mit der Endpunktadresse hinzu.

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

Parameter

implementedContract

String

Der vom Endpunkt implementierte Vertrag.

binding

Binding

Die Binding-Einstellung für den hinzugefügten Endpunkt.

address

Uri

Der Uri, der die Adresse für den hinzugefügten Endpunkt enthält. Dies kann ein absoluter oder relativer URI sein. Im Falle eines relativen URI wird eine der Basisadressen von ServiceHost (je nach Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

Gibt zurück

ServiceEndpoint

Der ServiceEndpoint, der dem gehosteten Dienst hinzugefügt wurde.

Ausnahmen

ArgumentNullException

implementedContract oder binding oder address oder ist null.

InvalidOperationException

Dieser Host befindet sich nicht in einem Created-Zustand oder in einem Opening-Zustand, oder es gibt keine ServiceDescription-Einstellung für den gehosteten Dienst, weshalb kein Endpunkt hinzugefügt werden kann.

AddServiceEndpoint(String, Binding, String, Uri)

Fügt dem gehosteten Dienst einen Dienstendpunkt mit einem angegebenen Vertrag, einer Bindung, einer Endpunktadresse und einem URI hinzu, der die Adresse enthält, die er überwacht.

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

Parameter

implementedContract

String

Der vom Endpunkt implementierte Vertrag.

binding

Binding

Die Binding-Einstellung für den hinzugefügten Endpunkt.

address

String

Die Adresse für den hinzugefügten Endpunkt. Die Adresse kann ein absoluter oder relativer URI sein. Im Falle eines relativen URI wird eine der Basisadressen von ServiceHost (je nach Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

listenUri

Uri

Der Uri, der die Adresse enthält, die der Endpunkt auf eingehende Nachrichten überwacht. Dieser URI kann relativ oder absolut sein.

Gibt zurück

ServiceEndpoint

Der ServiceEndpoint, der dem gehosteten Dienst hinzugefügt wurde.

Ausnahmen

ArgumentNullException

implementedContract oder binding oder address oder ist null.

InvalidOperationException

Dieser Host befindet sich nicht in einem Created-Zustand oder in einem Opening-Zustand, oder es gibt keine ServiceDescription-Einstellung für den gehosteten Dienst, weshalb kein Endpunkt hinzugefügt werden kann.

Hinweise

Wenn ein address relativer URI ist, wird eine der Basisadressen des ServiceHost (abhängig vom Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

AddServiceEndpoint(String, Binding, Uri, Uri)

Fügt dem gehosteten Dienst einen Dienstendpunkt mit dem angegebenen Vertrag, einer Bindung und URIs mit den Endpunkt- und Überwachungsadressen hinzu.

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

Parameter

implementedContract

String

Der vom Endpunkt implementierte Vertrag.

binding

Binding

Die Binding-Einstellung für den hinzugefügten Endpunkt.

address

Uri

Der Uri, der die Adresse für den hinzugefügten Endpunkt enthält. Im Falle eines relativen URI wird eine der Basisadressen von ServiceHost (je nach Bindungsprotokoll) als Basisadresse des Endpunkts verwendet.

listenUri

Uri

Der Uri, der die Adresse enthält, an der der Endpunkt nach eingehenden Nachrichten lauscht.

Gibt zurück

ServiceEndpoint

Der ServiceEndpoint, der dem gehosteten Dienst hinzugefügt wurde. Dieser URI kann absolut oder relativ sein.

Ausnahmen

ArgumentNullException

implementedContract oder binding oder address oder ist null.

InvalidOperationException

Dieser Host befindet sich nicht in einem Created-Zustand oder in einem Opening-Zustand, oder es gibt keine ServiceDescription-Einstellung für den gehosteten Dienst, weshalb kein Endpunkt hinzugefügt werden kann.