MessagePropertyAttribute 類別

定義

表示以自訂訊息類型在本機傳遞、但沒有序列化進入 SOAP 訊息的資料。Represents data that is passed locally with a custom message type but not serialized into a SOAP message.

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
type MessagePropertyAttribute = class
    inherit Attribute
Public NotInheritable Class MessagePropertyAttribute
Inherits Attribute
繼承
MessagePropertyAttribute
屬性

範例

下列程式碼範例示範 MessagePropertyAttribute 屬性的使用方式。The following code example demonstrates the use of the MessagePropertyAttribute attribute.

[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 訊息。Use the MessagePropertyAttribute attribute to attach data to the custom message type as it passes through the Windows Communication Foundation (WCF) system without serializing the data into a SOAP message.

建構函式

MessagePropertyAttribute()

初始化 MessagePropertyAttribute 類別的新執行個體。Initializes a new instance of the MessagePropertyAttribute class.

屬性

Name

取得或設定屬性的名稱。Gets or sets the name of the property.

TypeId

在衍生類別中實作時,取得這個 Attribute 的唯一識別碼。When implemented in a derived class, gets a unique identifier for this Attribute.

(繼承來源 Attribute)

方法

Equals(Object)

傳回值,這個值指出此執行個體是否與指定的物件相等。Returns a value that indicates whether this instance is equal to a specified object.

(繼承來源 Attribute)
GetHashCode()

傳回此執行個體的雜湊碼。Returns the hash code for this instance.

(繼承來源 Attribute)
GetType()

Gets the Type of the current instance.Gets the Type of the current instance.

(繼承來源 Object)
IsDefaultAttribute()

在衍生類別中覆寫時,表示這個執行個體的值是衍生類別的預設值。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(繼承來源 Attribute)
Match(Object)

在衍生類別中覆寫時,會傳回值,表示這個執行個體是否等於指定物件。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(繼承來源 Attribute)
MemberwiseClone()

Creates a shallow copy of the current Object.Creates a shallow copy of the current Object.

(繼承來源 Object)
ToString()

Returns a string that represents the current object.Returns a string that represents the current object.

(繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。Maps a set of names to a corresponding set of dispatch identifiers.

(繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

擷取物件的類型資訊,可以用來取得介面的類型資訊。Retrieves the type information for an object, which can be used to get the type information for an interface.

(繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

擷取物件提供的類型資訊介面數目 (0 或 1)。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供物件所公開的屬性和方法的存取權。Provides access to properties and methods exposed by an object.

(繼承來源 Attribute)

適用於