MessageContractAttribute Sınıf

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.1.1

Kaynak:

MessageContractAttribute.cs

SOAP iletisine karşılık gelen kesin türe sahip bir sınıf tanımlar.

C#

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct, AllowMultiple=false)]
public sealed class MessageContractAttribute : Attribute

Devralma

Object

Attribute

MessageContractAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki kod örneği, hem istek iletisi hem de yanıt iletisi için SOAP zarf yapısını denetlemek için öğesinin kullanımını MessageContractAttribute ve hem MessageHeaderAttribute (yanıt iletisi için bir SOAP üst bilgisi oluşturmak için) hem MessageBodyMemberAttribute de (hem isteğin hem de yanıt iletisinin gövdelerini belirtmek için) kullanımını gösterir. Kod örneği, gönderildiğinde her iletinin bir örneğini içerir.

C#

using System;
using System.Collections.Generic;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Channels;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace = "Microsoft.WCF.Documentation")]
  interface IMessagingHello
  {
    [OperationContract(
     Action = "http://GreetingMessage/Action",
     ReplyAction = "http://HelloResponseMessage/Action"
    )]
    HelloResponseMessage Hello(HelloGreetingMessage msg);
  }

  [MessageContract]
  public class HelloResponseMessage
  {
    private string localResponse = String.Empty;
    private string extra = String.Empty;

    [MessageBodyMember(
      Name = "ResponseToGreeting",
      Namespace = "http://www.examples.com")]
    public string Response
    {
      get { return localResponse; }
      set { localResponse = value; }
    }

    [MessageHeader(
      Name = "OutOfBandData",
      Namespace = "http://www.examples.com",
      MustUnderstand=true
    )]
    public string ExtraValues
    {
      get { return extra; }
      set { this.extra = value; }
   }

   /*
    The following is the response message, edited for clarity.

    <s:Envelope>
      <s:Header>
        <a:Action s:mustUnderstand="1">http://HelloResponseMessage/Action</a:Action>
        <h:OutOfBandData s:mustUnderstand="1" xmlns:h="http://www.examples.com">Served by object 13804354.</h:OutOfBandData>
      </s:Header>
      <s:Body>
        <HelloResponseMessage xmlns="Microsoft.WCF.Documentation">
          <ResponseToGreeting xmlns="http://www.examples.com">Service received: Hello.</ResponseToGreeting>
        </HelloResponseMessage>
      </s:Body>
    </s:Envelope>
    */
 }
  [MessageContract]
  public class HelloGreetingMessage
  {
    private string localGreeting;

    [MessageBodyMember(
      Name = "Salutations",
      Namespace = "http://www.examples.com"
    )]
    public string Greeting
    {
      get { return localGreeting; }
      set { localGreeting = value; }
    }
  }

  /*
   The following is the request message, edited for clarity.

    <s:Envelope>
      <s:Header>
        <!-- Note: Some header content has been removed for clarity.
        <a:Action>http://GreetingMessage/Action</a:Action>
        <a:To s:mustUnderstand="1"></a:To>
      </s:Header>
      <s:Body u:Id="_0" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
        <HelloGreetingMessage xmlns="Microsoft.WCF.Documentation">
          <Salutations xmlns="http://www.examples.com">Hello.</Salutations>
        </HelloGreetingMessage>
      </s:Body>
   </s:Envelope>
   */

  class MessagingHello : IMessagingHello
  {
    public HelloResponseMessage Hello(HelloGreetingMessage msg)
    {
      Console.WriteLine("Caller sent: " + msg.Greeting);
      HelloResponseMessage responseMsg = new HelloResponseMessage();
      responseMsg.Response = "Service received: " + msg.Greeting;
      responseMsg.ExtraValues = String.Format("Served by object {0}.", this.GetHashCode().ToString());
      Console.WriteLine("Returned response message.");
      return responseMsg;
    }
  }
}

Açıklamalar

MessageContractAttribute Belirli bir ileti için SOAP zarfının yapısını belirtmek için özniteliğini kullanın. Hizmetiniz daha sonra iletiyi parametre olarak kullanabilir veya hizmet işlemlerinde dönüş türü olarak kullanabilir. Varsayılan SOAP zarfını değiştirmeden SOAP gövdesinin içeriğinin seri hale getirilmesini denetleme hakkında bilgi için bkz System.Runtime.Serialization.DataContractAttribute. , Hizmet Sözleşmelerinde Veri Aktarımı Belirtme ve Veri Sözleşmelerini Kullanma.

Not

Hizmet işleminizde özel ileti türlerini normal serileştirilebilir parametrelerle kullanamazsınız. Özel ileti türleri veya nesne olmayan Message serileştirilebilir parametreler kullanın. Ayrıntılar için bkz. Hizmet Sözleşmelerinde Veri Aktarımı Belirtme.

Bir tür için ileti sözleşmesi uygulamak için, ile MessageContractAttribute açıklama ekleyin ve bir veya daha fazla sınıf alanı veya özelliğine , MessageHeaderAttributeveya MessageHeaderArrayAttributeile MessageBodyMemberAttributeek açıklama ekleyin.

Not

System.ServiceModel.MessageParameterAttribute bir ileti sözleşmesi özniteliği değildir ve ile MessageContractAttributebirlikte kullanılamaz.

SOAP iletisindeki Action öğesinin <Action> değerini belirtmek için ve ReplyAction özelliklerini kullanın.

• HasProtectionLevel SOAP ileti türünün koruma düzeyine sahip olup olmadığını ve varsa ne olduğunu belirtmek için ve ProtectionLevel özelliklerini kullanın.

• İleti gövdesinin IsWrapped sarmalayıcı öğesi olup olmadığını belirtmek için özelliğini kullanın ve varsa, sarmalama öğesinin WrapperName adını ve ad alanını belirtmek için ve WrapperNamespace özelliklerini kullanın.

Daha fazla bilgi için bkz. İleti Sözleşmelerini Kullanma.

Oluşturucular

MessageContractAttribute()

MessageContractAttribute sınıfının yeni bir örneğini başlatır.

Özellikler

IsWrapped	İleti gövdesinin sarmalayıcı öğesi olup olmadığını belirten bir değer alır veya ayarlar.
WrapperName	İleti gövdesinin sarmalayıcı öğesinin adını alır veya ayarlar.
WrapperNamespace	İleti gövdesi sarmalayıcı öğesinin ad alanını alır veya ayarlar.

Şunlara uygulanır