Gewusst wie: Verwenden des Windows Communication Foundation-Dienstmonikers ohne Registrierung

Soll eine Verbindung mit einem Windows Communication Foundation (WCF)-Dienst hergestellt und mit diesem kommuniziert werden, benötigt eine WCF-Clientanwendung die genauen Daten der Dienstadresse, der Bindungskonfiguration und des Dienstvertrags.

Der WCF-Dienstmoniker ruft in der Regel den erforderlichen Vertrag über vorherige Registrierung der erforderlichen Attributtypen ab, doch in manchen Fällen ist dies nicht möglich. Anstelle der Registrierung kann der Moniker die Definition des Vertrags in Form eines Web Services Definition Language (WSDL)-Dokuments abrufen. Dies geschieht durch Verwendung des wsdl-Parameters, durch Metadatenaustausch oder durch Verwendung des mexAddress-Parameters.

Dadurch wird beispielsweise die Verteilung eines Excel-Arbeitsblatts, in dem einige Zellenwerte anhand von Webdienstinteraktionen berechnet werden, ermöglicht. In diesem Szenario kann die Dienstvertragassembly möglicherweise nicht auf allen Clients registriert werden, von denen das Dokument ggf. geöffnet wird. Der wsdl-Parameter oder der mexAddress-Parameter aktiviert eine in sich geschlossene Projektmappe.

Tipp

Gegenseitige Authentifizierung muss verwendet werden, um Schutz vor Anforderungs- und Antwortmanipulation oder Spoofing zu bieten. Insbesondere benötigen Clients die Gewährleistung, dass es sich beim antwortenden Endpunkt des Metadatenaustauschs um die gewünschte vertrauenswürdige Partei handelt.

Beispiel

In diesem Beispiel wird die Verwendung des Dienstmonikers mit einem MEX-Vertrag veranschaulicht. Ein Dienst mit dem folgenden Vertrag wird mit wsHttpBinding verfügbar gemacht.

using System.ServiceModel;

...

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Demo")]
public interface IAffiliate
{
    [OperationContract]
    bool NewAffiliate(string ID, string company, string fullname, string accountsCode);
    [OperationContract]
    bool RemoveAffiliate(string ID);
    [OperationContract]
    double RevenueCheckMonthly(ref string ID);
    [OperationContract]
    double RevenueCheckTotal(ref string ID);
}

Um einen WCF-Client für den Remotedienst zu erstellen, kann die folgende Beispielmonikerzeichenfolge verwendet werden.

service:mexAddress="https://servername/Affiliates/service.svc/mex",
address="https://servername/Affiliates/service.svc",
contract=IAffiliate, contractNamespace=http://Microsoft.ServiceModel.Demo,
binding=WSHttpBinding_IAffiliate, bindingNamespace=http://tempuri.org/

Während der Ausführung der Clientanwendung führt der Client WS-MetadataExchange mit der bereitgestellten mexAddress aus. Dabei werden unter Umständen Adresse, Bindung und Vertragsdetails für eine Reihe von Diensten zurückgegeben. Der address-Parameter, der contract-Parameter, der contractNamespace-Parameter, der binding-Parameter und der bindingNamespace-Parameter werden zum Identifizieren des gewünschten Diensts verwendet. Nach dem Abgleich dieser Parameter erstellt der Moniker einen WCF-Client mit der erforderlichen Vertragsdefinition. Anschließend können Aufrufe mithilfe des WCF-Clients wie beim typisierten Vertrag ausgelöst werden.

Tipp

Ist der Moniker nicht ordnungsgemäß formatiert oder der Dienst nicht verfügbar, wird nach dem GetObject-Aufruf ein Syntaxfehler zurückgegeben. Vergewissern Sie sich bei Auftreten dieses Fehlers, dass der verwendete Moniker korrekt und der Dienst verfügbar ist.

Siehe auch

Aufgaben

Gewusst wie: Registrieren und Konfigurieren eines Dienstmonikers