Bagikan melalui

Tutorial: Menentukan kontrak layanan WCF

Tutorial ini menjelaskan tugas pertama dari lima tugas yang diperlukan untuk membuat aplikasi dasar Windows Communication Foundation (WCF). Untuk gambaran umum tutorial, lihat Tutorial: Mulai menggunakan aplikasi Windows Communication Foundation.

Saat Anda membuat layanan WCF, tugas pertama Anda adalah menentukan kontrak layanan. Kontrak layanan menentukan operasi apa yang didukung layanan. Operasi dapat dianggap sebagai metode layanan Web. Anda membuat kontrak layanan dengan menentukan antarmuka C# atau Visual Basic. Antarmuka memiliki karakteristik berikut:

Dalam tutorial ini, Anda akan mempelajari cara:

  • Membuat proyek Pustaka Layanan WCF.
  • Menentukan antarmuka kontrak layanan.

Membuat proyek Pustaka Layanan WCF dan menentukan antarmuka kontrak layanan

  1. Buka Visual Studio sebagai administrator. Untuk melakukannya, pilih program Visual Studio di menu Mulai, lalu pilih Lebih Banyak>Jalankan sebagai administrator dari menu pintasan.

  2. Membuat proyek Pustaka Layanan WCF.

    1. Pada menu File, pilih Proyek>Baru.

    2. Dalam dialog Project Baru, di sisi kiri, perluas Visual C# atau Visual Basic, lalu pilih kategori WCF. Visual Studio menampilkan daftar templat proyek di bagian tengah jendela. Pilih Pustaka Layanan WCF.

      Catatan

      Jika Anda tidak melihat kategori templat proyek WCF, Anda mungkin perlu memasang komponen WCF dari Visual Studio. Dalam kotak dialog Project Baru, pilih link Buka alat penginstal Visual Studio di sisi kiri. Pilih tab Komponen individual, lalu temukan dan pilih WCF di bawah kategori Aktivitas pengembangan. Pilih Ubah untuk mulai memasang komponen.

    3. Di bagian bawah jendela, masukkan GettingStartedLib untuk Nama dan GettingStarted untuk Nama solusi.

    4. Pilih OK.

      Visual Studio membuat proyek, yang memiliki tiga file: IService1.cs (atau IService1.vb untuk proyek Visual Basic), Service1.cs (atau Service1.vb untuk proyek Visual Basic), dan App.config. Visual Studio mendefinisikan file-file ini sebagai berikut:

      • File IService1 berisi definisi default kontrak layanan.
      • File Service1 berisi implementasi default kontrak layanan.
      • File App.config berisi info konfigurasi yang diperlukan untuk memuat layanan default dengan alat Visual Studio WCF Service Host. Untuk informasi selengkapnya tentang alat Host Layanan WCF, lihat Host Layanan WCF (WcfSvcHost.exe).

      Catatan

      Jika Anda memasang Visual Studio dengan pengaturan lingkungan pengembang Visual Basic, solusinya mungkin disembunyikan. Jika demikian, pilih Opsi dari menu Alat, lalu pilih Proyek dan Solusi>Umum di jendela Opsi. Pilih Selalu tampilkan solusi. Selain itu, verifikasi bahwa Simpan proyek baru saat dibuat dipilih.

  3. Dari Penjelajah Solusi, buka file IService1.cs atau IService1.vb, dan ganti kodenya dengan kode berikut:

    using System;
using System.ServiceModel;

namespace GettingStartedLib
{
        [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
        public interface ICalculator
        {
            [OperationContract]
            double Add(double n1, double n2);
            [OperationContract]
            double Subtract(double n1, double n2);
            [OperationContract]
            double Multiply(double n1, double n2);
            [OperationContract]
            double Divide(double n1, double n2);
        }
}

    Imports System.ServiceModel

Namespace GettingStartedLib

    <ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _
    Public Interface ICalculator

        <OperationContract()> _
        Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()> _
        Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()> _
        Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()> _
        Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
    End Interface
End Namespace

    Kontrak ini mendefinisikan kalkulator online. Perhatikan bahwa antarmuka ICalculator ditandai dengan atribut ServiceContractAttribute (disederhanakan sebagai ServiceContract). Atribut ini mendefinisikan namespace layanan untuk membedakan nama kontrak. Kode menandai setiap operasi kalkulator dengan atribut OperationContractAttribute (disederhanakan sebagai OperationContract).

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara:

  • Membuat proyek Pustaka Layanan WCF.
  • Menentukan antarmuka kontrak layanan.

Lanjutkan ke tutorial berikutnya untuk mempelajari cara menerapkan kontrak layanan WCF.

Tutorial: Menerapkan kontrak layanan WCF

  • Last updated on