SoapFieldAttribute 類別

定義

命名空間:

System.Runtime.Remoting.Metadata

組件:

mscorlib.dll

替欄位自訂 SOAP 產生和處理。 此類別無法獲得繼承。

public ref class SoapFieldAttribute sealed : System::Runtime::Remoting::Metadata::SoapAttribute

[System.AttributeUsage(System.AttributeTargets.Field)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Field)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapFieldAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute

繼承

Object

Attribute

SoapAttribute

SoapFieldAttribute

屬性

AttributeUsageAttribute ComVisibleAttribute

範例

下列程式代碼範例示範使用 為類別 SoapFieldAttribute欄位產生的 SOAP 自定義。 SOAP 可由類別範例中顯示的 SerializableAttribute 程式代碼產生。

[Serializable]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public ref class TestSimpleObject
{
public:
   int member1;

   [SoapFieldAttribute(XmlElementName="MyXmlElement")] String^ member2;

   String^ member3;
   double member4;

   // A field that is not serialized.

   [NonSerialized] String^ member5;

   TestSimpleObject()
   {
      member1 = 11;
      member2 = "hello";
      member3 = "hello";
      member4 = 3.14159265;
      member5 = "hello world!";
   }
};

[Serializable()]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public class TestSimpleObject  {

    public int member1;

    [SoapFieldAttribute(XmlElementName="MyXmlElement")] public string member2;

    public string member3;
    public double member4;

    // A field that is not serialized.
    [NonSerialized()] public string member5;

    public TestSimpleObject() {

        member1 = 11;
        member2 = "hello";
        member3 = "hello";
        member4 = 3.14159265;
        member5 = "hello world!";
    }
}

<Serializable(), SoapTypeAttribute(XmlNamespace := "MyXmlNamespace")> Public Class TestSimpleObject
   
   Public member1 As Integer

   <SoapFieldAttribute(XmlElementName := "MyXmlElement")> Public member2 As String
   
   Public member3 As String
   Public member4 As Double

   ' A field that is not serialized.
   <NonSerialized()> Public member5 As String  


   Public Sub New()
      member1 = 11
      member2 = "hello"
      member3 = "hello"
      member4 = 3.14159265
      member5 = "hello world!"
   End Sub

End Class

備註

屬性的目標對 SoapFieldAttribute 像是物件欄位。 屬性SoapFieldAttribute可用來指定控制 .NET Framework 如何產生目標欄位的 SOAP XML 線路格式的資訊。

建構函式

SoapFieldAttribute()

建立 SoapFieldAttribute 類別的執行個體。

欄位

ProtXmlNamespace	XML 命名空間，用於序列化目前 SOAP 屬性的目標。 (繼承來源 SoapAttribute)
ReflectInfo	反映 (Reflection) 物件，由衍生自 SoapAttribute 類別的屬性類別用來設定 XML 序列化資訊。 (繼承來源 SoapAttribute)

屬性

Embedded	取得或設定值，指出型別在 SOAP 序列化 (Serialization) 期間是否必須為巢狀的。 (繼承來源 SoapAttribute)
Order	取得或設定目前欄位屬性的順序。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
UseAttribute	取得或設定值，指出目前屬性的目標是否將序列化為 XML 屬性以代替 XML 欄位。 (繼承來源 SoapAttribute)
XmlElementName	取得或設定包含在 SoapFieldAttribute 屬性中的欄位的 XML 項目名稱。
XmlNamespace	取得或設定 XML 命名空間名稱。 (繼承來源 SoapAttribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
IsInteropXmlElement()	傳回值，指出目前屬性是否含有 Interop XML 項目值。
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)