My.WebServices-Objekt

Aktualisiert: November 2007

Stellt Eigenschaften bereit, mit denen eine Einzelinstanz jedes XML-Webdienstes, auf die das aktuelle Projekt verweist, erstellt werden oder auf diese Einzelinstanz zugegriffen werden kann.

Hinweise

Das My.WebServices-Objekt stellt eine Instanz jedes Webdienstes bereit, auf die das aktuelle Projekt verweist. Jede Instanz wird bei Bedarf instanziiert. Sie können auf diese Webdienste über die Eigenschaften des My.WebServices-Objekts zugreifen. Der Name der Eigenschaft stimmt mit dem Namen des Webdienstes überein, auf den die Eigenschaft zugreift. Jede Klasse, die von SoapHttpClientProtocol erbt, ist ein Webdienst. Informationen über das Hinzufügen von Webdiensten zu einem Projekt finden Sie unter Gewusst wie: Zugreifen auf einen Webdienst in verwaltetem Code.

Das My.WebServices-Objekt macht nur die dem aktuellen Projekt zugeordneten Webdienste verfügbar. Es ermöglicht nicht den Zugriff auf Webdienste, die in DLLs deklariert sind, auf die verwiesen wird. Um auf einen Webdienst zuzugreifen, der von einer DLL bereitgestellt wird, müssen Sie den qualifizierten Namen des Webdiensts im Format DLL-Name.Webdienstname verwenden. Weitere Informationen finden Sie unter Zugriff auf Webdienste in verwaltetem Code.

Das Objekt und seine Eigenschaften sind für Webanwendungen nicht verfügbar.

Eigenschaften

Jede Eigenschaft des My.WebServices-Objekts ermöglicht den Zugriff auf eine Instanz eines Webdienstes, auf die das aktuelle Projekt verweist. Der Name der Eigenschaft stimmt mit dem Namen des Webdienstes überein, auf den die Eigenschaft zugreift, und der Eigenschaftentyp stimmt mit dem Typ des Webdienstes überein.

Hinweis:

Wenn ein Namenskonflikt besteht, lautet der Eigenschaftenname für den Zugriff auf einen Webdienst Stammnamespace_Namespace_Dienstname. Stellen Sie sich beispielsweise zwei Webdienste mit dem Namen Service1 vor. Wenn sich einer dieser Dienste im Stammnamespace WindowsApplication1 und im Namespace Namespace1 befindet, rufen Sie den Dienst über My.WebServices.WindowsApplication1_Namespace1_Service1 auf.

Beim ersten Zugriff auf eine der Eigenschaften des My.WebServices-Objekts erstellt die Eigenschaft eine neue Instanz des Webdienstes und speichert diese. Bei anschließenden Zugriffen auf diese Eigenschaft wird diese Instanz des Webdienstes zurückgegeben.

Sie können einen Webdienst freigeben, indem Sie der Eigenschaft für diesen Webdienst Nothing zuweisen. Der Eigenschaftensetter weist dem gespeicherten Wert Nothing zu. Wenn Sie der Eigenschaft einen anderen Wert als Nothing zuweisen, löst der Setter eine ArgumentException-Ausnahme aus.

Mit dem Is-Operator oder dem IsNot-Operator können Sie überprüfen, ob eine Eigenschaft des My.WebServices-Objekts eines Instanz des Webdienstes speichert. Sie können mit diesen Operatoren überprüfen, ob der Wert der Eigenschaft Nothing ist.

Hinweis:

Normalerweise muss der Is-Operator oder der IsNot-Operator den Wert der Eigenschaft lesen, um den Vergleich durchzuführen. Wenn die Eigenschaft gegenwärtig jedoch Nothing speichert, erstellt sie eine neue Instanz des Webdienstes und gibt dann diese Instanz zurück. Der Visual Basic-Compiler behandelt aber die Eigenschaften des My.WebServices-Objekts auf besondere Weise und lässt das Überprüfen des Status der Eigenschaft durch den Is-Operator oder den IsNot-Operator ohne eine Änderung ihres Werts zu.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit dem My.Forms-Objekt.

Beispiel

In diesem Beispiel wird die FahrenheitToCelsius-Methode des TemperatureConverter-XML-Webdienstes aufgerufen und das Ergebnis zurückgegeben.

Function ConvertFromFahrenheitToCelsius( _
    ByVal dFahrenheit As Double) _
    As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

Damit dieses Beispiel ausgeführt werden kann, muss das Projekt auf den Webdienst Converter verweisen, und dieser Webdienst muss die ConvertTemperature-Methode verfügbar machen. Weitere Informationen finden Sie unter Gewusst wie: Zugreifen auf einen Webdienst in verwaltetem Code.

Dieser Code kann in einem Webanwendungsprojekt nicht ausgeführt werden.

Voraussetzungen

Verfügbarkeit nach Projekttyp

Siehe auch

Aufgaben

Gewusst wie: Zugreifen auf einen Webdienst in verwaltetem Code

Konzepte

Zugreifen auf Anwendungswebdienste

Referenz

SoapHttpClientProtocol

ArgumentException

Weitere Ressourcen

Zugriff auf Webdienste in verwaltetem Code