Menggunakan Alat Penyedia Referensi Layanan Web WCF

Selama bertahun-tahun, banyak pengembang Visual Studio telah menikmati produktivitas yang disediakan alat Tambahkan Referensi Layanan ketika proyek .NET Framework mereka diperlukan untuk mengakses layanan web.

Alat Referensi Layanan Web WCF adalah ekstensi layanan terhubung Visual Studio yang memungkinkan Anda menyambungkan proyek .NET 5+, .NET Core, atau ASP.NET Core ke layanan web. Ini memberikan pengalaman yang mirip dengan fungsionalitas Tambahkan Referensi Layanan, yang hanya untuk proyek .NET Framework. Alat Referensi Layanan Web WCF mengambil metadata dari layanan web dalam solusi saat ini, di lokasi jaringan, atau dari file WSDL, dan menghasilkan file sumber yang berisi kode proksi klien Windows Communication Foundation (WCF) yang dapat digunakan aplikasi .NET Anda untuk mengakses layanan web.

Penting

Anda seharusnya hanya mereferensikan layanan dari sumber tepercaya. Menambahkan referensi dari sumber yang tidak dipercaya dapat membahayakan keamanan.

Prasyarat

• Visual Studio 2017 versi 15.5 atau versi yang lebih baru

Cuplikan layar dalam artikel ini berasal dari Visual Studio 2022.

Cara menggunakan ekstensi

Catatan

Alat Referensi Layanan Web WCF hanya berlaku untuk proyek C# .NET Core dan .NET Standard, termasuk aplikasi Web ASP.NET Core.

Menggunakan templat proyek ASP.NET Core Web Application sebagai contoh, artikel ini memandu Anda menambahkan referensi layanan WCF ke proyek.

1. Di Penjelajah Solusi, klik dua kali simpul Layanan Koneksi proyek. (Untuk proyek .NET Core atau .NET Standard, klik kanan pada proyek dan pilih Tambah> Koneksi Layanan.)

   Halaman Layanan Koneksi muncul seperti yang ditunjukkan pada gambar berikut:

   

2. Pada halaman Layanan Koneksi, pilih Tambahkan Referensi Layanan.

   Halaman Tambahkan referensi layanan terbuka.

3. Pilih Layanan Web WCF, lalu pilih Berikutnya.

   Ini memunculkan wizard Tambahkan referensi layanan Web Service WCF baru.

   

4. Pilih layanan.

   a. Ada beberapa opsi pencarian layanan yang tersedia:

   • Untuk mencari layanan yang ditentukan dalam solusi saat ini, klik tombol Temukan .
   • Untuk mencari layanan yang dihosting di alamat tertentu, masukkan URL layanan di kotak Alamat dan klik tombol Buka .
   • Untuk memilih file WSDL yang berisi informasi metadata layanan web, klik tombol Telusuri .

   b. Pilih layanan dari daftar hasil pencarian dalam kotak Layanan . Jika diperlukan, masukkan namespace untuk kode yang dihasilkan di kotak teks Namespace yang sesuai.

   c. Klik tombol Berikutnya untuk menentukan opsi tipe data atau opsi klien. Atau, klik tombol Selesai untuk menggunakan opsi default.

5. Halaman opsi jenis data memungkinkan penyempurnaan pengaturan konfigurasi referensi layanan yang dihasilkan:

   

   Catatan

   Opsi kotak centang Gunakan kembali jenis dalam rakitan yang direferensikan berguna saat jenis data yang diperlukan untuk pembuatan kode referensi layanan ditentukan dalam salah satu rakitan yang direferensikan proyek Anda. Penting untuk menggunakan kembali jenis data yang ada untuk menghindari masalah bentrokan jenis waktu kompilasi atau runtime.

   Mungkin ada penundaan saat informasi jenis dimuat, tergantung pada jumlah dependensi proyek dan faktor performa sistem lainnya. Tombol Selesai dinonaktifkan selama pemuatan kecuali kotak centang Gunakan kembali jenis dalam rakitan yang direferensikan tidak dicentang.

6. Klik Selesai saat Anda selesai.

Saat menampilkan kemajuan, alat ini:

• Mengunduh metadata dari layanan WCF.
• Menghasilkan kode referensi layanan dalam file bernama reference.cs, dan menambahkannya ke proyek Anda di bawah simpul Layanan yang Koneksi.
• Memperbarui file proyek (.csproj) dengan referensi paket NuGet yang diperlukan untuk mengkompilasi dan berjalan pada platform target.

Ketika proses ini selesai, Anda dapat membuat instans jenis klien WCF yang dihasilkan dan memanggil operasi layanan.

Lihat juga

• Mulai menggunakan aplikasi Windows Communication Foundation
• Layanan Windows Communication Foundation dan layanan data WCF di Visual Studio
• Fitur yang didukung WCF pada .NET Core

Umpan balik & pertanyaan

Jika Anda memiliki umpan balik produk, laporkan di Komunitas Pengembang menggunakan alat Laporkan masalah .

Catatan rilis

• Lihat Catatan rilis untuk informasi rilis yang diperbarui, termasuk masalah yang diketahui.