Menjalankan Contoh Windows Communication Foundation

  • Artikel

Sampel Windows Communication Foundation (WCF) dapat dijalankan dalam konfigurasi satu komputer atau lintas mesin. Seperti yang disediakan, sampel siap berjalan pada satu mesin. Dalam konfigurasi lintas mesin, perlu untuk memodifikasi pengaturan file konfigurasi sampel. Prosedur berikut menjelaskan cara menjalankan sampel dalam konfigurasi mesin dan lintas mesin yang sama. Perhatikan bahwa ada variasi dalam langkah-langkah untuk layanan yang dihosting di Layanan Informasi Internet (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 hak istimewa yang ditinggikan untuk mendaftarkan pendengar dengan Http.sys. Gunakan Httpcfg.exe untuk mendaftarkan alamat mendengarkan layanan dengan akun yang dijalankan layanan, atau luncurkan layanan dari perintah yang berjalan dengan hak istimewa administrator.

Catatan

Sebelum membangun atau menjalankan salah satu sampel WCF, pastikan Anda telah melakukan Prosedur Penyiapan Satu Kali untuk Sampel Windows Communication Foundation.

Untuk menjalankan sampel pada mesin 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 sampel di seluruh mesin

  1. Jika layanan dihosting di IIS:

    1. Pada mesin layanan, buat direktori virtual bernama ServiceModelSamples. File batch Setupvroot.bat disertakan dengan Prosedur Penyiapan Satu Kali 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 di mesin layanan. Pastikan Anda menyertakan file dalam direktori \bin.

    3. Uji apakah Anda dapat mengakses layanan dari mesin klien menggunakan browser.

    Jika layanan dihost sendiri:

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

    2. Salin file program layanan dari folder \service\bin\, di bawah folder khusus bahasa, ke mesin 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 perintah.

  2. Salin file program klien dari folder \client\bin\, di bawah folder khusus bahasa, ke mesin 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 daripada 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 mereka adalah pengaturan default. Untuk informasi selengkapnya tentang informasi identitas, lihat Identitas dan Autentikasi Layanan, dan <identitas>.

  4. Di mesin klien, luncurkan Client.exe dari jendela 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 sampel

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

Lihat juga