Freigeben über

My.WebServices-Objekt

Stellt Eigenschaften zum Erstellen und Zugreifen auf eine einzelne Instanz jedes XML-Webdiensts bereit, auf den vom aktuellen Projekt verwiesen wird.

Bemerkungen

Das My.WebServices Objekt stellt eine Instanz der einzelnen Webdienste bereit, auf die vom aktuellen Projekt verwiesen wird. Jede Instanz wird bei Bedarf instanziiert. Sie können über die Eigenschaften des My.WebServices Objekts auf diese Webdienste zugreifen. Der Name der Eigenschaft stimmt mit dem des Webdienstes überein, auf den die Eigenschaft zugreift. Jede Klasse, die von SoapHttpClientProtocol erbt, ist ein Webdienst. Informationen zum Hinzufügen von Webdiensten zu einem Projekt finden Sie unter Zugreifen auf Anwendungswebdienste.

Das My.WebServices Objekt macht nur die Webdienste verfügbar, die dem aktuellen Projekt zugeordnet sind. Er bietet keinen Zugriff auf Webdienste, die in referenzierten DLLs deklariert sind. Um auf einen Webdienst zuzugreifen, den eine DLL bereitstellt, müssen Sie den qualifizierten Namen des Webdiensts im Format DllName verwenden. WebServiceName. Weitere Informationen finden Sie unter Zugreifen auf Anwendungswebdienste.

Das Objekt und die zugehörigen Eigenschaften sind für Webanwendungen nicht verfügbar.

Eigenschaften

Jede Eigenschaft des My.WebServices Objekts bietet Zugriff auf eine Instanz eines Webdiensts, auf den vom aktuellen Projekt verwiesen wird. Der Name der Eigenschaft entspricht dem Namen des Webdiensts, auf den die Eigenschaft zugreift, und der Eigenschaftstyp entspricht dem Typ des Webdiensts.

Hinweis

Wenn ein Namenskonflikt besteht, lautet der Eigenschaftsname für den Zugriff auf einen Webdienst "RootNamespace_Namespace_ServiceName". Betrachten Sie z. B. zwei Webdienste mit dem Namen Service1. Wenn sich einer dieser Dienste im Stammnamespace WindowsApplication1 und im Namespace Namespace1befindet, greifen Sie auf diesen Dienst mithilfe My.WebServices.WindowsApplication1_Namespace1_Service1von .

Wenn Sie zum ersten Mal auf eine der Eigenschaften des My.WebServices Objekts zugreifen, wird eine neue Instanz des Webdiensts erstellt und gespeichert. Nachfolgende Zugriffe dieser Eigenschaft geben diese Instanz des Webdiensts zurück.

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

Sie können testen, ob eine Eigenschaft des My.WebServices Objekts eine Instanz des Webdiensts mithilfe Is des Operators speichert IsNot . Mit diesen Operatoren können Sie überprüfen, ob der Wert der Eigenschaft lautet Nothing.

Hinweis

Normalerweise muss der IsIsNot Operator den Wert der Eigenschaft lesen, um den Vergleich durchzuführen. Wenn die Eigenschaft derzeit gespeichert wird Nothing, erstellt die Eigenschaft jedoch eine neue Instanz des Webdiensts und gibt diese Instanz zurück. Der Visual Basic-Compiler behandelt jedoch die Eigenschaften des My.WebServices Objekts speziell und ermöglicht es dem IsIsNot Operator, den Status der Eigenschaft zu überprüfen, ohne den Wert zu ändern.

Beispiel

In diesem Beispiel wird die FahrenheitToCelsius Methode des TemperatureConverter XML-Webdiensts 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 funktioniert, muss Ihr Projekt auf einen Webdienst mit dem Namen Converterverweisen, und dieser Webdienst muss die ConvertTemperature Methode verfügbar machen. Weitere Informationen finden Sie unter Zugreifen auf Anwendungswebdienste.

Dieser Code funktioniert nicht in einem Webanwendungsprojekt.

Anforderungen

Verfügbarkeit nach Projekttyp

Projekttyp Verfügbar
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Ja
Windows-Dienst Ja
Website Nein

Siehe auch