MessagePropertyAttribute 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.Primitives.dll

組件:

System.ServiceModel.dll

表示以自訂訊息類型在本機傳遞、但沒有序列化進入 SOAP 訊息的資料。

public ref class MessagePropertyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public sealed class MessagePropertyAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, Inherited=false)]
public sealed class MessagePropertyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type MessagePropertyAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, Inherited=false)>]
type MessagePropertyAttribute = class
    inherit Attribute

Public NotInheritable Class MessagePropertyAttribute
Inherits Attribute

繼承

Object

Attribute

MessagePropertyAttribute

屬性

AttributeUsageAttribute

範例

下列程式碼範例示範 MessagePropertyAttribute 屬性的使用方式。

[MessageContractAttribute]
public class CustomMessage
{
    private Person internalPerson;
    [MessageProperty]
    private int a = 23;
    [MessageBodyMember(Name="Person")]
    public PersonType Data
    {
        get
        {
            return internalPerson;
        }
        set
        {
            this.internalPerson = (Person)value;
        }
    }
}

<MessageContractAttribute> _
Public Class CustomMessage
    Private internalPerson As Person
    <MessageProperty> _
    Private a As Integer = 23
    <MessageBodyMember(Name:="Person")> _
    Public Property Data() As PersonType
        Get
            Return internalPerson
        End Get
        Set(ByVal value As PersonType)
            Me.internalPerson = CType(value, Person)
        End Set
    End Property
End Class

備註

MessagePropertyAttribute使用 屬性，將資料附加至自訂訊息類型，因為它會通過 Windows Communication Foundation (WCF) 系統，而不會將資料序列化為 SOAP 訊息。

建構函式

MessagePropertyAttribute()

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

屬性

Name	取得或設定屬性的名稱。
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)