Share via


Gewusst wie: Konfigurieren eines WCF-Diensts für die Zusammenarbeit mit ASP.NET Webdienstclients

Verwenden Sie den Typ System.ServiceModel.BasicHttpBinding als Bindungstyp für Ihren Dienstendpunkt, um einen Windows Communication Foundation (WCF)-Dienstendpunkt so zu konfigurieren, dass er mit ASP.NET-Webdienstclients zusammenarbeitet.

Sie können für die Bindung auch Unterstützung für HTTPS und Clientauthentifizierung auf Transportebene aktivieren. ASP.NET-Webdienstclients unterstützen keine MTOM-Nachrichtencodierung; daher sollte die Eigenschaft System.ServiceModel.BasicHttpBinding.MessageEncoding ihren Standardwert, System.ServiceModel.WSMessageEncoding.Text, behalten. ASP.NET-Webdienstclients unterstützen WS-Sicherheit nicht; deshalb sollte System.ServiceModel.BasicHttpBinding.Security auf Transport festgelegt werden.

Um die Metadaten eines WCF-Diensts den ASP.NET-Webdienst-Proxygenerierungstools (also dem Web Services Description Language Tool (Wsdl.exe), dem Web Services Discovery Tool (Disco.exe) (beides möglicherweise in englischer Sprache) und der Funktion "Webverweis hinzufügen" von Visual Studio) zur Verfügung zu stellen, müssen Sie einen HTTP/GET-Metadatenendpunkt freigeben.

So fügen Sie einen WCF-Endpunkt hinzu, der im Code mit ASP.NET-Webdienstclients kompatibel ist

  1. Erstellen Sie eine neue BasicHttpBinding-Instanz.

  2. Aktivieren Sie optional Transportsicherheit für diese Dienstendpunktbindung, indem Sie den Sicherheitsmodus für die Bindung auf Transport festlegen. Ausführliche Informationen finden Sie unter Transportsicherheit.

  3. Fügen Sie dem Diensthost einen neuen Anwendungsendpunkt mit der Bindungsinstanz hinzu, die Sie soeben erstellt haben. Ausführliche Informationen zum Hinzufügen eines Dienstendpunkts in den Code finden Sie unter Gewusst wie: Erstellen eines Dienstendpunkts im Code.

  4. Aktivieren Sie einen HTTP/GET-Metadatenendpunkt für Ihren Dienst. Ausführliche Informationen finden Sie unter Gewusst wie: Veröffentlichen von Metadaten für einen Dienst über den Code.

So fügen Sie einen WCF-Endpunkt, der mit ASP.NET-Webdienstclients kompatibel ist, einer Konfigurationsdatei hinzu.

  1. Erstellen Sie eine neue BasicHttpBinding-Bindungskonfiguration. Ausführliche Informationen finden Sie unter Gewusst wie: Angeben einer Dienstbindung in einer Konfiguration.

  2. Aktivieren Sie optional Transportsicherheit für diese Dienstendpunkt-Bindungskonfiguration, indem Sie den Sicherheitsmodus für die Bindung auf Transport festlegen. Weitere Informationen finden Sie unter Transportsicherheit.

  3. Konfigurieren Sie einen neuen Anwendungsendpunkt für Ihren Dienst, indem Sie die Bindungskonfiguration verwenden, die Sie gerade erstellt haben. Weitere Informationen zum Hinzufügen eines Dienstendpunkts zu einer Konfigurationsdatei finden Sie unter Gewusst wie: Erstellen eines Dienstendpunkts in einer Konfiguration.

  4. Aktivieren Sie einen HTTP/GET-Metadatenendpunkt für Ihren Dienst. Ausführliche Informationen finden Sie unter Gewusst wie: Veröffentlichen von Metadaten für einen Dienst mithilfe einer Konfigurationsdatei.

Beispiel

Der folgende Beispielcode zeigt das Hinzufügen eines WCF-Endpunkts, der im Code und alternativ in den Konfigurationsdateien kompatibel mit den ASP.NET-Webdienstclients ist.

Siehe auch

Aufgaben

Gewusst wie: Erstellen eines Dienstendpunkts im Code
Gewusst wie: Veröffentlichen von Metadaten für einen Dienst über den Code
Gewusst wie: Angeben einer Dienstbindung in einer Konfiguration
Gewusst wie: Erstellen eines Dienstendpunkts in einer Konfiguration
Gewusst wie: Veröffentlichen von Metadaten für einen Dienst mithilfe einer Konfigurationsdatei

Konzepte

Verwenden von Metadaten

Weitere Ressourcen

Transportsicherheit