Bagikan melalui

Objek My.WebServices

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

Komentar

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 My.WebServices objek. 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 Application Web Services.

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 formulir DllName. WebServiceName. Untuk informasi selengkapnya, lihat Mengakses Layanan Web Aplikasi.

Objek dan propertinya tidak tersedia untuk aplikasi Web.

Karakteristik

Setiap properti My.WebServices objek 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.

Nota

Jika ada tabrakan nama, 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 WindowsApplication1 layanan akar dan di namespace Namespace1layanan , Anda akan mengakses layanan tersebut dengan menggunakan My.WebServices.WindowsApplication1_Namespace1_Service1.

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

Anda dapat membuang layanan Web dengan menetapkan Nothing ke properti untuk layanan Web tersebut. Setter properti menetapkan Nothing ke nilai tersimpan. Jika Anda menetapkan nilai apa pun selain Nothing ke properti , setter akan melemparkan ArgumentException pengecualian.

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

Nota

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

Contoh

Contoh ini memanggil FahrenheitToCelsius metode TemperatureConverter layanan Web XML, dan mengembalikan 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 ConvertTemperature harus mengekspos metode . 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
Perpustakaan Kontrol Situs Web Ya
Layanan Windows Ya
Situs Web Tidak.

Lihat juga

  • Last updated on