SoapTypeAttribute 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
針對目標類型自訂 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)]
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)]
public sealed class SoapTypeAttribute : System.Runtime.Remoting.Metadata.SoapAttribute
[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)>]
type SoapTypeAttribute = class
inherit 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
- 繼承
- 屬性
範例
以下程式碼範例展示了為類別 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 線路格式。
建構函式
| 名稱 | Description |
|---|---|
| SoapTypeAttribute() |
建立 的實例 SoapTypeAttribute。 |
欄位
| 名稱 | Description |
|---|---|
| ProtXmlNamespace |
當前 SOAP 屬性目標被序列化到的 XML 命名空間。 (繼承來源 SoapAttribute) |
| ReflectInfo |
一個反射物件,供從類別 SoapAttribute 衍生的屬性類別用來設定 XML 序列化資訊。 (繼承來源 SoapAttribute) |
屬性
| 名稱 | Description |
|---|---|
| Embedded |
會取得或設定一個值,指示該型別在 SOAP 序列化時是否必須巢狀。 (繼承來源 SoapAttribute) |
| SoapOptions |
取得或設定一個 SoapOption 設定值。 |
| TypeId |
在衍生類別中實作時,取得這個 Attribute的唯一標識碼。 (繼承來源 Attribute) |
| UseAttribute |
取得或設定一個值,指示當前屬性的目標是否會序列化為 XML 屬性,而非 XML 欄位。 |
| XmlElementName |
取得或設定 XML 元素名稱。 |
| XmlFieldOrder |
取得或設定目標物件類型的 XML 欄位順序。 |
| XmlNamespace |
取得或設定目標物件類型序列化時使用的 XML 命名空間。 |
| XmlTypeName |
取得或設定目標物件類型的 XML 類型名稱。 |
| XmlTypeNamespace |
取得或設定目前物件類型的 XML 類型命名空間。 |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
傳回值,這個值表示這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| GetHashCode() |
傳回這個實例的哈希碼。 (繼承來源 Attribute) |
| GetType() |
取得目前實例的 Type。 (繼承來源 Object) |
| IsDefaultAttribute() |
在衍生類別中覆寫時,指出這個實例的值是否為衍生類別的預設值。 (繼承來源 Attribute) |
| Match(Object) |
在衍生類別中覆寫時,傳回值,指出這個實例是否等於指定的物件。 (繼承來源 Attribute) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| _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) |