Aracılığıyla paylaş

Nasıl yapılır: İstek-Yanıt Sözleşmesi Oluşturma

  • Makale

İstek-yanıt sözleşmesi, yanıt döndüren bir yöntem belirtir. Yanıt bu sözleşmenin koşullarına göre gönderilmeli ve istekle ilişkilendirilmelidir. Yöntem yanıt döndürmese bile (void C# dilinde veya Sub Visual Basic'te), altyapı çağırana boş bir ileti oluşturur ve gönderir. Boş bir yanıt iletisinin gönderilmesini önlemek için, işlem için tek yönlü bir sözleşme kullanın.

İstek-yanıt sözleşmesi oluşturmak için

  1. Seçtiğiniz programlama dilinde bir arabirim oluşturun.

  2. özniteliğini ServiceContractAttribute arabirime uygulayın.

  3. özniteliğini istemcilerin OperationContractAttribute çağırabileceği her yönteme uygulayın.

  4. isteğe bağlı. Boş bir yanıt iletisinin IsOneWay gönderilmesini önlemek için özelliğinin true değerini olarak ayarlayın. Varsayılan olarak, tüm işlemler istek-yanıt sözleşmeleridir.

Örnek

Aşağıdaki örnek, ve Subtract yöntemleri sağlayan Add hesap makinesi hizmeti için bir sözleşme tanımlar. Multiply yöntemi, sınıf tarafından işaretlenmediğinden ve istemciler tarafından erişilemediğinden sözleşmenin OperationContractAttribute bir parçası değildir.

using System.ServiceModel;

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    // It would be equivalent to write explicitly:
    // [OperationContract(IsOneWay=false)]
    int Add(int a, int b);

    [OperationContract]
    int Subtract(int a, int b);

    int Multiply(int a, int b)
}

  • İşlem sözleşmelerini belirtme hakkında daha fazla bilgi için sınıfına OperationContractAttribute ve özelliğine IsOneWay bakın.

  • ServiceContractAttribute ve OperationContractAttribute özniteliklerinin uygulanması, hizmet dağıtıldıktan sonra bir Web Hizmetleri Açıklama Dili (WSDL) belgesinde hizmet sözleşmesi tanımlarının otomatik olarak oluşturulmasına neden olur. Belge, hizmetin HTTP temel adresine eklenerek ?wsdl indirilir. Örneğin http://microsoft/CalculatorService?wsdl

Ayrıca bkz.