MessageContractMemberAttribute Class

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.1.0

Source:

MessageContractMemberAttribute.cs

Declares the base members for MessageBodyMemberAttribute and MessageHeaderAttribute.

public ref class MessageContractMemberAttribute abstract : Attribute

public abstract class MessageContractMemberAttribute : Attribute

type MessageContractMemberAttribute = class
    inherit Attribute

Public MustInherit Class MessageContractMemberAttribute
Inherits Attribute

Inheritance

Object

Attribute

MessageContractMemberAttribute

Derived

System.ServiceModel.MessageBodyMemberAttribute

System.ServiceModel.MessageHeaderAttribute

Examples

The following code examples demonstrate a custom message contract that uses the MessageContractAttribute, MessageHeaderAttribute, and MessageBodyMemberAttribute attributes (which all inherit from MessageContractMemberAttribute) to create custom typed messages to use in operations. In this case, there are three members that are serialized into the body element of the SOAP message: sourceAccount, targetAccount, and the amount value, (which is serialized into an element with the name transactionAmount). In addition, the IsAudited SOAP header element resides in the http://schemas.contosobank.com/auditing/2005 namespace, and sourceAccount is encrypted and digitally signed.

Note

The Operation and Account types must have a data contract.

[MessageContract]  
public class BankingTransaction  
{  
  [MessageHeader]   
  public Operation operation;  
  [MessageHeader(Namespace="http://schemas.contosobank.com/auditing/2005")]   
  public bool IsAudited;  
  [MessageBody(ProtectionLevel=ProtectionLevel.EncryptAndSign)]   
  public Account sourceAccount;  
  [MessageBody]   
  public Account targetAccount;  
  [MessageBody(Name="transactionAmount")]   
  public int amount;  

Remarks

This class contains properties common to all parts of a SOAP message. For example, all parts have a name and a namespace, and potentially a level of security applied.

For information on controlling the serialization of the contents of a SOAP body without modifying the default SOAP envelope itself, see System.Runtime.Serialization.DataContractAttribute, Specifying Data Transfer in Service Contracts, and Using Data Contracts.

For more information about creating message contracts, see Using Message Contracts.

Constructors

MessageContractMemberAttribute()

Initializes a new instance of the MessageContractMemberAttribute class.

Properties

Name	Specifies the name of the element that corresponds to this member.
Namespace	Specifies the namespace of the element that corresponds to this member.
TypeId	When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)

Methods

Equals(Object)	Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute)
GetHashCode()	Returns the hash code for this instance. (Inherited from Attribute)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)