SoapTypeAttribute 類別

定義

命名空間:

System.Runtime.Remoting.Metadata

組件:

mscorlib.dll

替目標型別自訂 SOAP 產生和處理。 此類別無法獲得繼承。

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

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapTypeAttribute : System.Runtime.Remoting.Metadata.SoapAttribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapTypeAttribute = class
    inherit SoapAttribute

Public NotInheritable Class SoapTypeAttribute
Inherits SoapAttribute

繼承

Object

Attribute

SoapAttribute

SoapTypeAttribute

屬性

AttributeUsageAttribute ComVisibleAttribute

範例

下列程式碼範例示範使用 SoapTypeAttribute 為 類別產生的 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

備註

屬性 SoapTypeAttribute 是可套用至物件、實數值型別和介面物件的自訂屬性。 這個屬性可用來指定物件類型的相關資訊，以控制 SOAP 如何產生 SOAP XML 線路格式。

建構函式

SoapTypeAttribute()

建立 SoapTypeAttribute 的執行個體。

欄位

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

屬性

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

方法

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)