MessageContractAttribute Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.1.1

Źródło:

MessageContractAttribute.cs

Definiuje silnie typizowana klasę odpowiadającą komunikatowi SOAP.

C#

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

Dziedziczenie

Object

Attribute

MessageContractAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie kodu pokazano użycie elementu MessageContractAttribute do kontrolowania struktury koperty protokołu SOAP zarówno dla komunikatu żądania, jak i komunikatu odpowiedzi, oraz użycia zarówno MessageHeaderAttribute nagłówka protokołu SOAP dla komunikatu odpowiedzi, jak i MessageBodyMemberAttribute (w celu określenia treści zarówno żądania, jak i komunikatu odpowiedzi). Przykładowy kod zawiera przykład każdego komunikatu po wysłaniu.

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;
    }
  }
}

Uwagi

Użyj atrybutu MessageContractAttribute , aby określić strukturę koperty protokołu SOAP dla określonego komunikatu. Usługa może następnie użyć komunikatu jako parametru lub zwracać typ operacji usługi. Aby uzyskać informacje na temat kontrolowania serializacji zawartości treści protokołu SOAP bez modyfikowania domyślnej koperty protokołu SOAP, zobacz System.Runtime.Serialization.DataContractAttribute, Określanie transferu danych w kontraktach usług i Używanie kontraktów danych.

Uwaga

W operacji usługi nie można używać niestandardowych typów komunikatów ze zwykłymi parametrami możliwych do serializacji. Użyj niestandardowych typów komunikatów lub parametrów możliwych do serializacji, które nie Message są obiektami. Aby uzyskać szczegółowe informacje, zobacz , Określanie transferu danych w kontraktach usług.

Aby zaimplementować kontrakt komunikatu dla typu, dodaj do niego MessageContractAttribute adnotację i dodaj adnotację do co najmniej jednego pola lub właściwości klasy za pomocą MessageBodyMemberAttribute, MessageHeaderAttributelub MessageHeaderArrayAttribute.

Uwaga

System.ServiceModel.MessageParameterAttribute nie jest atrybutem kontraktu komunikatu i nie można go używać w połączeniu z MessageContractAttribute.

Action Użyj właściwości iReplyAction, aby określić wartość <Action> elementu w komunikacie SOAP.

• HasProtectionLevel Użyj właściwości i ProtectionLevel , aby wskazać, czy typ komunikatu PROTOKOŁU SOAP ma poziom ochrony, a jeśli tak, to co to jest.

• IsWrapped Użyj właściwości , aby wskazać, czy treść komunikatu ma element otoki, a jeśli tak, użyj WrapperName właściwości i WrapperNamespace , aby określić odpowiednio nazwę i przestrzeń nazw elementu opakowującego.

Aby uzyskać więcej informacji, zobacz Korzystanie z kontraktów komunikatów.

Konstruktory

MessageContractAttribute()

Inicjuje nowe wystąpienie klasy MessageContractAttribute.

Właściwości

IsWrapped	Pobiera lub ustawia wartość określającą, czy treść komunikatu ma element otoki.
WrapperName	Pobiera lub ustawia nazwę elementu otoki treści wiadomości.
WrapperNamespace	Pobiera lub ustawia przestrzeń nazw elementu otoki treści komunikatu.

Dotyczy