MessageContractMemberAttribute 類別

定義

public ref class MessageContractMemberAttribute abstract : Attribute

public abstract class MessageContractMemberAttribute : Attribute

type MessageContractMemberAttribute = class
    inherit Attribute

Public MustInherit Class MessageContractMemberAttribute
Inherits Attribute

繼承

Object

Attribute

MessageContractMemberAttribute

衍生

System.ServiceModel.MessageBodyMemberAttribute

System.ServiceModel.MessageHeaderAttribute

範例

以下程式碼範例展示了一個自訂訊息合約，利用 MessageContractAttribute、 MessageHeaderAttribute和 MessageBodyMemberAttribute 屬性（皆繼承自 MessageContractMemberAttribute）來建立自訂型別訊息以用於操作。 在此情況下，有三個成員被序列化成 SOAP 訊息的主體元素：sourceAccount、 ，以及 targetAccount 值（序列化為名為 amount的transactionAmount元素）。 此外， IsAudited SOAP 標頭元素位於 http://schemas.contosobank.com/auditing/2005 命名空間中，並 sourceAccount 經過加密並進行數位簽名。

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

備註

此類別包含 SOAP 訊息所有部分共有的屬性。 例如，所有部分都有名稱和命名空間，並且可能還會套用一定的安全等級。

關於如何在不修改預設 SOAP 信封本身的情況下控制 SOAP 主體內容的序列化資訊，請參見 System.Runtime.Serialization.DataContractAttribute《 服務合約中的資料傳輸規範》及 《使用資料合約》。

欲了解更多關於建立訊息合約的資訊，請參閱 「使用訊息合約」。