MessageBodyMemberAttribute Clase

Definición

Espacio de nombres:

System.ServiceModel

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v8.1.1

Source:

MessageBodyMemberAttribute.cs

Especifica que un miembro se serializa como un elemento dentro del cuerpo de SOAP.

C#

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

Herencia

Object

Attribute

MessageContractMemberAttribute

MessageBodyMemberAttribute

Atributos

AttributeUsageAttribute

Ejemplos

El siguiente ejemplo de código muestra el uso de MessageContractAttribute para controlar la estructura de envoltura SOAP para el mensaje de solicitud y el mensaje de respuesta, y el uso de MessageHeaderAttribute (para crear un encabezado SOAP para el mensaje de respuesta) y MessageBodyMemberAttribute (para especificar los cuerpos del mensaje de solicitud y respuesta). El ejemplo de código contiene un ejemplo de cada mensaje cuando se envía.

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

Comentarios

Utilice el atributo MessageBodyMemberAttribute para especificar que un miembro de datos se serializa en el cuerpo de SOAP y para controlar algunos elementos de serialización.

La propiedad Order se utiliza para especificar el orden de partes del cuerpo en casos donde el orden alfabético predeterminado no es adecuado.

Las otras propiedades se heredan de la clase base, System.ServiceModel.MessageContractMemberAttribute.

Para obtener más información sobre cómo controlar la serialización del contenido de un cuerpo SOAP sin modificar el propio sobre SOAP predeterminado, vea System.Runtime.Serialization.DataContractAttribute, Especificar transferencia de datos en contratos de servicio y Uso de contratos de datos.

Para más información, consulte Uso de contratos de mensaje.

Constructores

MessageBodyMemberAttribute()

Inicializa una nueva instancia de la clase MessageBodyMemberAttribute.

Propiedades

Name	Especifica el nombre del elemento que se corresponde a este miembro. (Heredado de MessageContractMemberAttribute)
Namespace	Especifica el espacio de nombres del elemento que se corresponde a este miembro. (Heredado de MessageContractMemberAttribute)
Order	Obtiene o establece un valor que indica la posición en la que se serializa el miembro en el cuerpo de SOAP.

Se aplica a