Gewusst wie: Hinzufügen, Aktualisieren oder Entfernen eines Dienstverweises

Durch einen Dienstverweis kann ein Projekt auf einen oder mehrere Windows Communication Foundation (WCF)-Dienste zugreifen.Suchen Sie mithilfe des Dialogfelds Dienstverweis hinzufügen in der aktuellen Projektmappe, lokal, in einem lokalen Netzwerk oder im Internet nach WCF-Diensten.

Hinzufügen eines Dienstverweises

So fügen Sie einen Verweis auf einen externen Dienst hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem der Dienst hinzugefügt werden soll. Klicken Sie dann auf Dienstverweis hinzufügen.

   Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.

2. Geben Sie im Feld Adresse die URL des Diensts ein, und klicken Sie dann auf Gehe zu, um nach dem Dienst zu suchen.Wenn der Dienst eine Benutzernamen-/Kennwortsicherheit implementiert, müssen Sie einen Benutzernamen und ein Kennwort eingeben.

   Hinweis
   Sie sollten nur auf Dienste aus einer vertrauenswürdigen Quelle verweisen.Das Hinzufügen von Verweisen aus einer nicht vertrauenswürdigen Quelle kann die Sicherheit beeinträchtigen.

   Hinweis
   Sie können die URL auch aus einer Dropdownliste auswählen, die die letzten 15 URLs speichert, unter denen gültige Dienstmetadaten gefunden wurden.

   Während der Suche wird eine Statusanzeige angezeigt.Sie können die Suche jederzeit beenden, indem Sie auf die Schaltfläche Beenden klicken.

3. Erweitern Sie in der Liste Dienst den Knoten für den gewünschten Dienst, und wählen Sie einen Dienstvertrag aus.

4. Geben Sie im Feld Namespace den Namespace ein, den Sie für den Verweis verwenden möchten.

5. Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.

   Ein Dienstclient (Proxy) wird generiert, und der Datei app.config werden Metadaten hinzugefügt, mit denen der Dienst beschrieben wird.

So fügen Sie der aktuellen Projektmappe einen Verweis auf einen Dienst hinzu

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, dem der Dienst hinzugefügt werden soll. Klicken Sie dann auf Dienstverweis hinzufügen.

   Das Dialogfeld Dienstverweis hinzufügen wird angezeigt.

2. Klicken Sie auf Ermitteln.

   Der Liste Dienst werden alle WCF-Dienste der aktuellen Projektmappe hinzugefügt.

3. Erweitern Sie in der Liste Dienst den Knoten für den gewünschten Dienst, und wählen Sie einen Dienstvertrag aus.

4. Geben Sie im Feld Namespace den Namespace ein, den Sie für den Verweis verwenden möchten.

5. Klicken Sie auf OK, um dem Projekt den Verweis hinzuzufügen.

6. Ein Dienstclient (Proxy) wird generiert, und der Datei app.config werden Metadaten hinzugefügt, mit denen der Dienst beschrieben wird.

Aktualisieren eines Dienstverweises

Im Laufe der Zeit können sich die Metadaten für einen WCF-Dienst ändern. Daher muss der Dienstverweis gegebenenfalls aktualisiert werden.

So aktualisieren Sie einen Dienstverweis

• Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und klicken Sie dann auf Dienstverweis aktualisieren.

  Ein Statusdialogfeld wird angezeigt während der Verweis vom ursprünglichen Speicherort aktualisiert wird. Der Dienstclient wird erneut generiert, um jede Änderung in den Metadaten widerzuspiegeln.

Entfernen eines Dienstverweises

Wenn ein Dienstverweis nicht mehr verwendet wird, können Sie ihn aus der Projektmappe entfernen.

So entfernen Sie einen Dienstverweis

• Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Dienstverweis, und klicken Sie dann auf Löschen.

  Der Dienstclient wird aus der Projektmappe entfernt, und die Metadaten, die den Dienst beschreiben, werden aus der Datei app.config entfernt.

  Hinweis
  Code, der auf den Dienstverweis verweist, muss manuell entfernt werden.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen eines Verweises auf einen Webdienst

Referenz

Dialogfeld "Dienstverweis hinzufügen"

Konzepte

Windows Communication Foundation-Dienste und WCF Data Services in Visual Studio

Weitere Ressourcen

Consuming ASMX and WCF Services Sample