MessageContractMemberAttribute 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

組件:

System.ServiceModel.dll

宣告 MessageBodyMemberAttribute 和 MessageHeaderAttribute 的基底成員。

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

範例

下列程式碼範例示範使用 、 MessageHeaderAttribute 和 MessageBodyMemberAttribute 屬性的自訂訊息合約 MessageContractAttribute ， (這些屬性全都繼承自 MessageContractMemberAttribute) ，以建立自訂型別訊息以用於作業中。 在此案例中，有三個序列化成 SOAP 訊息本文項目的成員：sourceAccount、targetAccount 以及 amount 值 (序列化成名稱為 transactionAmount 的項目)。 此外，IsAudited SOAP 標頭項目位於 http://schemas.contosobank.com/auditing/2005 命名空間中，而 sourceAccount 已經過加密和數位簽署。

注意

Operation 和 Account 型別必須具有資料合約。

[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 在 服務合約中指定資料傳輸和使用 資料合約。

如需建立訊息合約的詳細資訊，請參閱 使用訊息合約。

建構函式

MessageContractMemberAttribute()

初始化 MessageContractMemberAttribute 類別的新執行個體。

屬性

HasProtectionLevel	在衍生類別中覆寫時，取得指出成員是否已指派保護層級的值。
Name	指定對應於這個成員的項目名稱。
Namespace	指定對應於這個成員的項目命名空間。
ProtectionLevel	指定成員要依現狀加以傳輸、簽署，或者加以簽署並加密。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)