Gewusst wie: Aktualisieren von Webdienstclient-URIs in Konfigurationsdateien

  • Artikel

Aktualisiert: November 2007

Wenn Sie die Bereitstellung von Webdienst-Consumeranwendungen planen, müssen Sie die zugehörigen Konfigurationsdateien mit den Speicherorten der Webdienste in der Bereitstellungsumgebung aktualisieren. Weitere Informationen finden Sie unter Anwendungsinformationen in Bereitstellungsberichten.

Bevor Sie diese Aufgabe durchführen, müssen Sie aber zunächst die absoluten URIs der Webdienst-Anbieterendpunkte aus der XML-Version des Bereitstellungsberichts abrufen. Weitere Informationen finden Sie unter Gewusst wie: Suchen von absoluten Webdienst- und Webinhalts-URIs in Bereitstellungsberichten.

So aktualisieren Sie den Webdienstclient-URI für eine ASP.NET-Anwendung

  1. Öffnen Sie die Datei Web.config für die ASP.NET-Anwendung, die mit dem Webdienst-Anbieterendpunkt verbunden ist.

  2. Suchen Sie in der Datei Web.config das <appSettings>-Element.

  3. Suchen Sie unter dem <appSettings>-Element das <add>-Element, dessen "Value"-Attribut mit dem Wert der Target Location-Eigenschaft des Webdienst-Consumerendpunkts übereinstimmt.

    Tipp:

    Sie können die Target Location-Eigenschaft suchen, indem Sie im Anwendungsdiagramm den Webdienst-Consumerendpunkt auswählen und F4 drücken, um das Fenster Eigenschaften zu öffnen.

  4. Kopieren Sie aus dem <add>-Element den Wert des "Key"-Attributs in die Config File Entry-Einstellung für den Webdienst-Consumerendpunkt.

    Tipp:

    Um die Config File Entry-Einstellung zu suchen, klicken Sie im Anwendungsdiagramm mit der rechten Maustaste auf den Webdienst-Consumerendpunkt, und wählen Sie Einstellungen und Einschränkungen aus. Wählen Sie im Einstellungs- und Einschränkungs-Editor den Knoten Einstellungen für den Anwendungsendpunkt aus. Die Config File Entry-Einstellung befindet sich im rechten Bereich des Einstellungs- und Einschränkungs-Editors. Weitere Informationen finden Sie unter Einstellungs- und Einschränkungs-Editor.

  5. Wenn Sie den absoluten URI für den verbundenen Webdienst-Anbieterendpunkt noch nicht abgerufen haben, rufen Sie diesen absoluten URI ab.

  6. Ersetzen Sie im <add>-Element den Wert im "Value"-Attribut durch den absoluten URI des Webdienst-Anbieterendpunkts.

    Tipp:

    Verwenden Sie bei Bedarf den Wert, den Sie in die Config File Entry-Einstellung kopiert haben, um nach dem <add>-Element mit einem passenden "Key"-Attributwert in der Datei Web.config zu suchen.

Durch das Kopieren des "Key"-Attributwerts in die Config File Entry-Einstellung wird der Eintrag der Konfigurationsdatei angegeben, der dem Consumerendpunkt zugeordnet wird. Bei der Bereitstellung bestimmt diese Einstellung, welcher Konfigurationsdateieintrag festgelegt werden soll, sobald Bereitstellungsparameter aufgelöst sind. Sie können mit dieser Einstellung auch den Wert in der Datei Web.config suchen, wenn Sie sie mit dem absoluten URI aktualisieren.

So aktualisieren Sie den Webdienstclient-URI für eine Windows- oder Office-Anwendung

  1. Öffnen Sie die Datei App.config für die Windows- oder Office-Anwendung, die mit dem Webdienst-Anbieterendpunkt verbunden ist.

  2. Suchen Sie in der Datei App.config das <applicationSettings>-Element.

  3. Suchen Sie unter dem <applicationSettings>-Element das folgende Element, wobei ApplicationName der entsprechende Anwendungsname ist:

    • <ApplicationName.Properties.Settings>-Element (Windows- und Office-Anwendungen in Visual C# und Visual J#)

    • <ApplicationName.My.MySettings>-Element (Windows-Anwendungen in Visual Basic)

    • <ApplicationName.Settings>-Element (Office-Anwendungen in Visual Basic)

  4. Suchen Sie innerhalb dieses Elements das <Setting>-Element, dessen "Value"-Attribut mit dem Wert der Target Location-Eigenschaft des Webdienst-Consumerendpunkts übereinstimmt.

    Tipp:

    Sie können die Target Location-Eigenschaft suchen, indem Sie im Anwendungsdiagramm den Webdienst-Consumerendpunkt auswählen und F4 drücken, um das Fenster Eigenschaften zu öffnen.

  5. Kopieren Sie vom <Setting>-Element den Wert des "Name"-Attributs in die Config File Entry-Einstellung für den Webdienst-Consumerendpunkt.

    Tipp:

    Um die Config File Entry-Einstellung zu suchen, klicken Sie im Anwendungsdiagramm mit der rechten Maustaste auf den Webdienst-Consumerendpunkt, und wählen Sie Einstellungen und Einschränkungen aus. Wählen Sie im Einstellungs- und Einschränkungs-Editor den Knoten Einstellungen für den Anwendungsendpunkt aus. Die Config File Entry-Einstellung befindet sich im rechten Bereich des Einstellungs- und Einschränkungs-Editors. Weitere Informationen finden Sie unter Einstellungs- und Einschränkungs-Editor.

  6. Wenn Sie den absoluten URI für den verbundenen Webdienst-Anbieterendpunkt noch nicht abgerufen haben, rufen Sie diesen absoluten URI ab.

  7. Ersetzen Sie unter dem passenden <Setting>-Element den Wert im "Value"-Attribut durch den absoluten URI des Webdienst-Anbieterendpunkts.

    Tipp:

    Verwenden Sie bei Bedarf den Wert, den Sie in die Config File Entry-Einstellung kopiert haben, um nach dem <Setting>-Element mit einem passenden "Name"-Attribut in der Datei App.config zu suchen.

Durch das Kopieren des "Name"-Attributwerts in die Config File Entry-Einstellung wird der Eintrag der Konfigurationsdatei angegeben, der dem Consumerendpunkt zugeordnet wird. Bei der Bereitstellung bestimmt diese Einstellung, welcher Konfigurationsdateieintrag festgelegt werden soll, sobald Bereitstellungsparameter aufgelöst sind. Sie können mit dieser Einstellung auch den Wert in der Datei App.config suchen, wenn Sie sie mit dem absoluten URI aktualisieren.

Siehe auch

Konzepte

Übersicht über die Bereitstellung mit Bereitstellungsberichten