My.WebServices Object

  • Artikel

Menyediakan properti untuk membuat dan mengakses satu instans dari setiap layanan Web XML yang direferensikan oleh proyek saat ini.

Keterangan

Objek My.WebServices menyediakan instans dari setiap layanan Web yang dirujuk oleh proyek saat ini. Setiap instans dibuat sesuai permintaan. Anda dapat mengakses layanan Web ini melalui properti objek My.WebServices. Nama properti sama dengan nama layanan Web yang diakses properti. Kelas apa pun yang mewarisi dari SoapHttpClientProtocol adalah layanan Web. Untuk informasi tentang menambahkan layanan Web ke proyek, lihat Mengakses Layanan Web Aplikasi.

Objek My.WebServices hanya mengekspos layanan Web yang terkait dengan proyek saat ini. Ini tidak menyediakan akses ke layanan Web yang dideklarasikan dalam DLL yang direferensikan. Untuk mengakses layanan Web yang disediakan DLL, Anda harus menggunakan nama layanan Web yang memenuhi syarat, dalam bentuk DllName.WebServiceName. Untuk informasi selengkapnya, lihat Mengakses Layanan Web Aplikasi.

Objek dan propertinya tidak tersedia untuk aplikasi Web.

Properti

Setiap properti objek My.WebServices menyediakan akses ke instans layanan Web yang dirujuk oleh proyek saat ini. Nama properti sama dengan nama layanan Web yang diakses properti, dan jenis properti sama dengan jenis layanan Web.

Catatan

Jika ada nama yang tumpang-tindih, nama properti untuk mengakses layanan Web adalah RootNamespace_Namespace_ServiceName. Misalnya, pertimbangkan dua layanan Web bernama Service1. Jika salah satu layanan ini berada di namespace root WindowsApplication1 dan di namespace Namespace1, Anda akan mengakses layanan tersebut menggunakan My.WebServices.WindowsApplication1_Namespace1_Service1.

Ketika Anda pertama kali mengakses salah satu properti objek My.WebServices, ia akan membuat instans baru layanan Web dan menyimpannya. Akses berikutnya dari properti tersebut menampilkan instans layanan Web tersebut.

Anda dapat membuang layanan Web dengan menetapkan Nothing ke properti untuk layanan Web tersebut. Pengatur properti menetapkan Nothing ke nilai tersimpan. Jika Anda menetapkan nilai apa pun selain Nothing ke properti, pengatur akan menampilkan pengecualian ArgumentException.

Anda dapat menguji apakah properti objek My.WebServices menyimpan instans layanan Web menggunakan operator Is atau IsNot. Anda dapat menggunakan operator tersebut untuk memeriksa apakah nilai properti adalah Nothing.

Catatan

Biasanya, operator Is atau IsNot harus membaca nilai properti untuk melakukan perbandingan. Namun, jika properti saat ini menyimpan Nothing, properti membuat instans baru layanan Web lalu menampilkan instans tersebut. Namun, pengompilasi Visual Basic memperlakukan properti objek My.WebServices secara khusus, dan memungkinkan operator Is atau IsNot untuk memeriksa status properti tanpa mengubah nilainya.

Contoh

Contoh ini memanggil metode FahrenheitToCelsius layanan Web XML TemperatureConverter, dan menampilkan hasilnya.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Agar contoh ini berfungsi, proyek Anda harus mereferensikan layanan Web bernama Converter, dan layanan Web tersebut harus mengekspos metode ConvertTemperature. Untuk informasi selengkapnya, lihat Mengakses Layanan Web Aplikasi.

Kode ini tidak berfungsi dalam proyek aplikasi Web.

Persyaratan

Ketersediaan menurut Jenis Proyek

Jenis proyek Tersedia
Aplikasi Windows Ya
Pustaka Kelas Ya
Aplikasi Konsol Ya
Pustaka Kontrol Windows Ya
Pustaka Kontrol Web Ya
Layanan Windows Ya
Situs Web No

Lihat juga