XmlMembersMapping 類別

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.XmlSerializer.dll

來源:

XmlMembersMapping.cs

提供針對 SOAP Web 服務所定義、介於 .NET Web 服務方法和 Web 服務描述語言 (WSDL) 訊息之間的對應。

此 API 支援此產品基礎結構，但無法直接用於程式碼之中。

public ref class XmlMembersMapping : System::Xml::Serialization::XmlMapping

public class XmlMembersMapping : System.Xml.Serialization.XmlMapping

type XmlMembersMapping = class
    inherit XmlMapping

Public Class XmlMembersMapping
Inherits XmlMapping

繼承

Object

XmlMapping

XmlMembersMapping

備註

XmlMembersMapping類別不會直接使用。 相反地，它會使用：

• 透過Wsdl.exe工具或 ServiceDescriptionImporter 類別，同時從 WSDL 檔案產生用戶端 Proxy 類別或抽象伺服器類別。 WSDL 檔案會指定 SOAP 通訊協定的使用方式。

• 若要在 XmlSerializer 初始化 SOAP Web 服務或用戶端時初始化.NET Framework物件。

• 透過 類別， ServiceDescriptionReflector 從識別為 SOAP Web 服務的類別建立 ServiceDescription 物件。

類別 XmlMembersMapping 是用來替代 XmlTypeMapping Web 服務方法和訊息之間的對應類別。 它用來包含屬於 SOAP Web 服務方法的下列任何實體：

• 輸入參數。

• 輸出參數和傳回值。

• 要求 SOAP 標頭。

• 回應 SOAP 標頭。

具體而言，類別會根據下列選擇來代表 WSDL 訊息定義的對應：

• 對於使用 SOAP 編碼的 Web 服務方法：最上層 ElementName 和 TypeName 屬性與父系包裝函式元素有關;訊息元件是由陣列成員表示。 不過，在極少數的情況下，當 Web 服務作業使用檔樣式與包裝的系結結合至.NET Framework方法加上 SOAP 編碼時，最上層 ElementName 和 TypeName 屬性會與出現在所產生 WSDL 檔案中的單一元件元素有關。

• 對於使用 XML 架構定義的常值 Web 服務方法：如果 Web 服務訊息或作業使用包裝的系結至.NET Framework方法，或只定義單一訊息元件，則最上層 ElementName 和 TypeName 與元件相關的屬性。 如果 (非典型案例) 有多個元件，最上層 ElementName 和 TypeName 屬性會與父系包裝函式元素有關;元件是由 Count 和 索引陣列存取屬性工作表示。 此外，XSD any 元素會接收特殊處理。

屬性

Count	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得屬於 SOAP 訊息所對應之 Web 服務方法的 .NET 程式碼實體數目。
ElementName	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得對應之元素的名稱。 (繼承來源 XmlMapping)
Item[Int32]	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得項目，其中含有屬於對應至 SOAP 訊息之 Web 服務方法的 .NET 程式碼實體的內部型別對應資訊。
Namespace	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得對應之項目的命名空間。 (繼承來源 XmlMapping)
TypeName	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得 .NET 型別的名稱，此型別會對應至代表 SOAP 訊息之 XML 結構描述元素的資料類型。
TypeNamespace	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得 .NET 型別的命名空間，此型別會對應至代表 SOAP 訊息之 XML 結構描述元素的資料類型。
XsdElementName	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得對應之 XSD 項目的名稱。 (繼承來源 XmlMapping)

方法

Equals(Object)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 做為預設雜湊函式。 (繼承來源 Object)
GetType()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 建立目前 Object 的淺層複製。 (繼承來源 Object)
SetKey(String)	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 設定用來查閱對應的索引鍵。 (繼承來源 XmlMapping)
ToString()	此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• XmlMemberMapping
• XmlReflectionMember
• XmlTypeMapping