Bagikan melalui

Membangun Sampel Windows Communication Foundation

Sampel Windows Communication Foundation (WCF) dapat dibuat menggunakan Visual Studio IDE atau perintah msbuild dari baris perintah. Kedua prosedur dijelaskan dalam artikel ini.

Nota

Sebelum membuat atau menjalankan salah satu sampel WCF, pastikan Anda telah melakukan Prosedur PenyiapanOne-Time untuk Sampel Windows Communication Foundation.

Untuk membangun sampel menggunakan Command Prompt

  1. Buka Perintah Pengembang untuk Visual Studio dan navigasikan ke subdirektori khusus bahasa di bawah lokasi direktori tempat Anda menginstal sampel.

  2. Ketik msbuild pada baris perintah. File program klien dibangun ke client\bin dan file program layanan dibangun ke service\bin. Jika layanan dihosting oleh Internet Information Services (IIS), file program layanan juga disalin ke direktori servicemodelsamples dan subdirektori \bin-nya .

Nota

Anda harus mengatur ACL pada %systemdrive%\inetpub\wwwroot untuk memberikan izin modifikasi ke akun tempat Anda menjalankan. Jika tidak, beberapa peristiwa pasca build akan gagal. Atau, Anda dapat meninggalkan ACL apa adanya dan menjalankan prompt perintah SDK sebagai administrator.

Untuk membuat sampel menggunakan Visual Studio

  1. Dari menu File di Visual Studio, pilih Buka>Proyek/Solusi. Navigasikan ke subdirektori khusus bahasa di bawah direktori tempat Anda menginstal sampel, dan klik dua kali ikon file .sln untuk membuka solusi di Visual Studio.

  2. Dari menu Build , pilih Bangun Ulang Solusi.

    File program klien dibangun ke client\bin dan file program layanan dibangun ke service\bin. Jika layanan dihosting di IIS, file program layanan juga disalin ke direktori servicemodelsamples dan subdirektori \bin-nya .

Nota

Anda harus mengatur ACL pada %systemdrive%\inetpub\wwwroot untuk memberikan izin modifikasi ke akun tempat Anda menjalankan. Jika tidak, beberapa peristiwa pasca build akan gagal. Atau, Anda dapat meninggalkan ACL apa adanya dan menjalankan prompt perintah SDK atau Visual Studio sebagai administrator. Beberapa tindakan Visual Studio (seperti melampirkan debugger ke proses ASP.NET pekerja) juga memerlukan hak istimewa administratif.

Pengaturan File Batch dan Skrip

Setup.exe dan Cleanup.exe file batch dan skrip harus dijalankan dari Developer Command Prompt untuk Visual Studio. Beberapa file pengaturan dan pembersihan melakukan tugas yang memerlukan hak istimewa administratif dan harus diluncurkan dengan hak istimewa administrator.

Informasi Keamanan Penting tentang Titik Akhir Metadata

Untuk mencegah pengungkapan metadata layanan yang berpotensi sensitif secara tidak disengaja, konfigurasi default untuk layanan Windows Communication Foundation (WCF) menonaktifkan penerbitan metadata. Perilaku ini aman secara default, tetapi juga berarti Anda tidak dapat menggunakan alat impor metadata (seperti Svcutil.exe) untuk menghasilkan kode klien yang diperlukan untuk memanggil layanan kecuali perilaku penerbitan metadata layanan diaktifkan secara eksplisit dalam konfigurasi. Untuk mempermudah bereksperimen dengan sampel, hampir semua sampel mengekspos titik akhir penerbitan metadata yang tidak aman. Titik akhir tersebut berpotensi tersedia untuk konsumen anonim dan tanpa autentikasi. Perhatian harus diberikan sebelum menggunakan titik akhir tersebut untuk memastikan bahwa pengungkapan metadata layanan secara publik sesuai. Untuk informasi selengkapnya tentang menerbitkan metadata layanan, lihat sampel Perilaku Penerbitan Metadata . Lihat sampel Titik Akhir Metadata Aman Kustom untuk sampel yang mengamankan titik akhir metadata.

Penanganan Pengecualian

Umumnya, sampel ini tidak menyertakan penanganan pengecualian untuk menjaga kode tetap fokus pada subjek sampel. Untuk informasi selengkapnya tentang penanganan pengecualian, lihat sampel Pengecualian yang Diharapkan .

Meregenerasi Klien dan Konfigurasi dengan Svcutil

Anda dapat menggunakan Alat Utilitas Metadata ServiceModel (Svcutil.exe) untuk meregenerasi kode dan konfigurasi klien untuk sebagian besar sampel. Beberapa sampel memerlukan konfigurasi yang diedit secara manual. Misalnya, jika Anda menggunakan Svcutil.exe untuk meregenerasi konfigurasi untuk sampel yang menggunakan kredensial sertifikat klien, Anda harus menentukan kredensial yang sebelumnya dikonfigurasi secara manual. Beberapa sampel menggunakan opsi Svcutil.exe tertentu untuk memengaruhi kode yang dihasilkan, opsi ini ditentukan dalam topik sampel tertentu.

Untuk meregenerasi file klien dan konfigurasi

  1. Buka perintah SDK dan navigasikan ke subdirektori khusus bahasa di bawah lokasi direktori tempat Anda menginstal sampel.

  2. Jika layanan adalah jenis yang dihosting Web, gunakan perintah berikut.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs

    Jika layanan adalah jenis yang dihost sendiri, ketik perintah berikut.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs

    Ganti http://localhost:8000/ServiceModelSamples/service.svc/mex dengan alamat titik akhir mex dari layanan yang di-host secara mandiri.

    Untuk menghasilkan klien dalam jenis Visual Basic, gunakan perintah berikut.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

    Jika layanan adalah jenis yang dihost sendiri, gunakan perintah berikut.

    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

    Nota

    Untuk melewati pembuatan konfigurasi klien, tambahkan opsi /noConfig .

Lihat juga