SoapIncludeAttribute 類別

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.XmlSerializer.dll

組件:

System.Xml.dll

組件:

netstandard.dll

允許 XmlSerializer 在將物件序列化或還原序列化為編碼 SOAP XML 時，辨認型別。

C#

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

C#

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true)]
public class SoapIncludeAttribute : Attribute

繼承

Object

Attribute

SoapIncludeAttribute

屬性

AttributeUsageAttribute

範例

下列範例會將 兩 SoapIncludeAttribute 次套用至 XML Web 服務方法。 方法會傳回類型 Vehicle (基類) 的物件。 SoapIncludeAttribute允許 方法傳回衍生自 類別的 Vehicle 類別實例。

備註

類別 SoapIncludeAttribute 屬於一系列屬性，可控制序列化或還原序列化物件的方式 XmlSerializer ，做為編碼的 SOAP XML。 產生的 XML 符合萬維網聯盟檔的第 5 節： 簡單物件存取通訊協定 (SOAP) 1.1。 如需類似屬性的完整清單，請參閱 控制編碼 SOAP 序列化的屬性。

若要將物件序列化為編碼的 SOAP 訊息，您必須使用 搭配 XmlTypeMapping 類別的 方法所建立 ImportTypeMapping 的 SoapReflectionImporter 來建構 XmlSerializer 。

套 SoapIncludeAttribute 用 時，請指定 Type 衍生類別的 。 XmlSerializer當 序列化同時包含基底和衍生類別的物件時，就可以辨識這兩種物件類型。

您可以使用 ， SoapIncludeAttribute 在 Web 服務描述語言 (WSDL) 撰寫的服務描述檔中包含衍生類別。 例如，如果方法傳 Object 回 ，請將 套用 SoapIncludeAttribute 至 方法，並指定應該傳回的實際型別。

如需 WSDL 的詳細資訊，請參閱萬維網聯盟規格、 Web 服務描述語言 (WSDL) 1.1。

如需使用屬性的詳細資訊，請參閱 屬性。

建構函式

SoapIncludeAttribute(Type)

使用指定的型別，初始化 SoapIncludeAttribute 類別的新執行個體。

屬性

Type	取得或設定物件的型別，用於序列化或還原序列化物件時。
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)

適用於