MessageBodyMemberAttribute Classe

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.1.1

Origine:

MessageBodyMemberAttribute.cs

Specifica che un membro viene serializzato come elemento all'interno del corpo SOAP.

C#

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, Inherited=false)]
public class MessageBodyMemberAttribute : System.ServiceModel.MessageContractMemberAttribute

Ereditarietà

Object

Attribute

MessageContractMemberAttribute

MessageBodyMemberAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'utilizzo di MessageContractAttribute per controllare la struttura della SOAP envelope per il messaggio di richiesta e il messaggio di risposta, nonché l'utilizzo di MessageHeaderAttribute per creare un'intestazione SOAP per il messaggio di risposta e di MessageBodyMemberAttribute per specificare i corpi dei messaggi di richiesta e di risposta. Nel codice è contenuto un esempio di ogni messaggio quando viene inviato.

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

Commenti

Utilizzare l'attributo MessageBodyMemberAttribute per specificare che un membro dati viene serializzato nel corpo SOAP e per controllare alcuni elementi della serializzazione.

La proprietà Order viene utilizzata per specificare l'ordine delle parti del corpo nei casi in cui l'ordine alfabetico predefinito non sia appropriato.

Le altre proprietà vengono ereditate dalla classe di base System.ServiceModel.MessageContractMemberAttribute.

Per altre informazioni sul controllo della serializzazione del contenuto di un corpo SOAP senza modificare la busta SOAP predefinita, vedere System.Runtime.Serialization.DataContractAttribute, Specifica del trasferimento dei dati nei contratti di servizio e Uso di contratti dati.

Per altre informazioni, vedere Uso di contratti di messaggio.

Costruttori

MessageBodyMemberAttribute()

Inizializza una nuova istanza della classe MessageBodyMemberAttribute.

Proprietà

Name	Specifica il nome dell'elemento che corrisponde a questo membro. (Ereditato da MessageContractMemberAttribute)
Namespace	Specifica lo spazio dei nomi dell'elemento che corrisponde a questo membro. (Ereditato da MessageContractMemberAttribute)
Order	Ottiene o imposta un valore che indica la posizione in cui il membro viene serializzato nel corpo SOAP.

Si applica a