Menjalankan Sampel Windows Communication Foundation

Sampel Windows Communication Foundation (WCF) dapat dijalankan dalam konfigurasi mesin tunggal atau lintas komputer. Seperti yang diberikan, sampel siap untuk dijalankan di satu mesin. Dalam konfigurasi lintas komputer, perlu untuk memodifikasi pengaturan file konfigurasi sampel. Prosedur ini menjelaskan cara menjalankan contoh dalam konfigurasi mesin yang sama dan konfigurasi lintas mesin. Perhatikan bahwa ada variasi dalam langkah-langkah untuk layanan yang dihosting di Internet Information Services (IIS) dan sampel yang dihost sendiri. Sebagian besar sampel dihosting di IIS; lihat contoh informasi readme untuk menentukan bagaimana informasi tersebut dihosting.

Pada Windows Vista, sampel yang tidak dihosting di IIS memerlukan izin yang lebih tinggi untuk mendaftarkan pendengar dengan Http.sys. Gunakan Httpcfg.exe untuk mendaftarkan alamat mendengarkan layanan dengan akun yang dijalankan layanan, atau luncurkan layanan dari prompt perintah yang berjalan dengan hak istimewa administrator.

Nota

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

Untuk menjalankan sampel pada komputer yang sama

  1. Jika layanan dihosting oleh IIS, pastikan Anda dapat mengakses layanan menggunakan browser dengan memasukkan alamat berikut: http://localhost/servicemodelsamples/service.svc. Halaman konfirmasi harus ditampilkan sebagai respons. Jika halaman konfirmasi tidak ditampilkan, lihat Tips Pemecahan Masalah untuk Sampel WCF.

  2. Jika layanan dihost sendiri, jalankan Service.exe dari \service\bin, dari bawah folder khusus bahasa. Aktivitas layanan ditampilkan di jendela konsol layanan.

  3. Jalankan Client.exe dari \client\bin\, dari bawah folder khusus bahasa. Aktivitas klien ditampilkan di jendela konsol klien.

  4. Jika klien dan layanan tidak dapat berkomunikasi, lihat Tips Pemecahan Masalah untuk Sampel WCF.

Untuk menjalankan contoh kode di berbagai komputer

  1. Jika layanan dihosting di IIS:

    1. Pada komputer layanan, buat direktori virtual bernama ServiceModelSamples. File batch Setupvroot.bat disertakan dengan Prosedur PenyiapanOne-Time untuk Sampel Windows Communication Foundation dapat digunakan untuk membuat direktori disk dan direktori virtual.

    2. Salin file program layanan dari %SystemDrive%\Inetpub\wwwroot\servicemodelsamples ke direktori virtual ServiceModelSamples pada komputer layanan. Pastikan Anda menyertakan file dalam direktori \bin.

    3. Uji bahwa Anda dapat mengakses layanan dari komputer klien menggunakan browser.

    Jika layanan dihost sendiri:

    1. Pada komputer layanan, buat direktori untuk menyimpan file layanan.

    2. Salin file program layanan dari folder \service\bin\, di bawah folder khusus bahasa, ke komputer layanan.

    3. Dalam file konfigurasi layanan, ubah nilai alamat definisi titik akhir agar sesuai dengan alamat baru layanan Anda. Ganti referensi apa pun ke "localhost" dengan nama domain yang sepenuhnya memenuhi syarat di alamat.

    4. Luncurkan Service.exe dari command prompt.

  2. Salin file program klien dari folder \client\bin\, di bawah folder khusus bahasa, ke komputer klien.

  3. Atur alamat titik akhir.

    1. Jika layanan tidak berjalan di bawah akun domain, buka file konfigurasi klien dan ubah nilai alamat definisi titik akhir agar sesuai dengan alamat baru layanan Anda. Ganti referensi apa pun ke "localhost" dengan nama domain yang sepenuhnya memenuhi syarat di alamat.

    2. Jika layanan berjalan di bawah akun domain, regenerasi konfigurasi klien dengan menjalankan Svcutil.exe terhadap layanan. Untuk informasi selengkapnya tentang menjalankan Svcutil.exe, lihat Membangun Sampel Windows Communication Foundation. Gunakan file yang dihasilkan alih-alih file konfigurasi dalam sampel. File konfigurasi yang dihasilkan memiliki informasi identitas tambahan, dan berisi semua pengaturan yang diperlukan untuk terhubung ke titik akhir layanan meskipun merupakan pengaturan default. Untuk informasi selengkapnya tentang informasi identitas, lihat Identitas dan Autentikasi Layanan, dan <identitas>.

  4. Pada komputer klien, luncurkan Client.exe dari prompt perintah.

Untuk men-debug layanan

  1. Bangun solusi (klien dan layanan) menggunakan menu Build atau Ctrl+Shift+B.

  2. Jika layanan dihosting di IIS:

    1. Aktifkan layanan menggunakan browser dengan memasukkan alamat http://localhost/servicemodelsamples/service.svc.

    2. Dalam solusi, pilih menu Debug dan item menu Lampirkan ke Proses .

    3. Pilih kotak centang Perlihatkan proses dari semua pengguna .

    4. Pilih proses pekerja host W3wp.exe untuk men-debug (pilih ASPNet_wp.exe di Windows XP).

  3. Anda sekarang dapat mengatur titik henti dalam kode layanan dan mengaktifkan titik henti pada pengecualian.

  4. Klik kanan item proyek klien dan pilih Debug, Mulai instans baru.

Untuk membersihkan setelah pengujian sampel

  • Jika layanan dihosting di IIS untuk tujuan keamanan, hapus definisi direktori virtual dan izin yang diberikan dalam langkah-langkah penyiapan ketika Anda selesai dengan sampel.

Lihat juga