XmlSerializerAssemblyAttribute 類別

定義

命名空間:

System.Xml.Serialization

組件:

System.Xml.XmlSerializer.dll

組件:

System.Xml.dll

組件:

netstandard.dll

套用至 Web 服務用戶端 Proxy 後，就可讓您指定含有自訂序列化程式的組件。

public ref class XmlSerializerAssemblyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct, AllowMultiple=false)]
public sealed class XmlSerializerAssemblyAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)]
public sealed class XmlSerializerAssemblyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct, AllowMultiple=false)>]
type XmlSerializerAssemblyAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)>]
type XmlSerializerAssemblyAttribute = class
    inherit Attribute

Public NotInheritable Class XmlSerializerAssemblyAttribute
Inherits Attribute

繼承

Object

Attribute

XmlSerializerAssemblyAttribute

屬性

AttributeUsageAttribute

備註

XmlSerializerAssemblyAttribute使用 來增加 Web 服務用戶端應用程式的效能。

使用此屬性的一般方法如下所示：

1. 建立 Web 服務的用戶端 Proxy。

2. 開啟 machine.config 檔。

3. 在 system.diagnostics 元素下，在 元素下 <switches> 新增值，以保留已編譯的檔案：

   <system.diagnostics>  
      <switches>  
         <add name="XmlSerialization.Compilation" value="4"/>  
      </switches>  
   </system.diagnostics>  
   

4. 編譯 Proxy。

5. 執行 Proxy 應用程式。

6. 開啟命令視窗，並流覽至 用來 XmlSerializer 快取檔案的 \Temp 目錄。

   cd %temp%  
   

7. 尋找使用 dir 命令搭配 /OD 參數所建立的最後一個檔案。

   dir *.vb /OD   
   

8. 將檔案編譯成元件。 將元件命名為 。

9. 將 套用 XmlSerializerAssemblyAttribute 至 類別，以編輯原始 Proxy 程式碼。 指定元件名稱，如下列 C# 程式碼所示。

   [XmlSerializerAssemblyAttribute(AssemblyName="hello.serializer")]  
   public class Hello: System.Web.Services.Protocols.SoapHttpClientProtocol {  
      // Proxy code not shown.  
   }  
   

<XmlSerializerAssemblyAttribute(AssemblyName:="hello.serializer")> _  
Public Class Hello  
Implements System.Web.Services.Protocols.SoapHttpClientProtocol   
   ' Proxy code not shown.  
End Class  

建構函式

XmlSerializerAssemblyAttribute()	初始化 XmlSerializerAssemblyAttribute 類別的新執行個體。
XmlSerializerAssemblyAttribute(String)	使用指定的組件名稱，初始化 XmlSerializerAssemblyAttribute 類別的新執行個體。
XmlSerializerAssemblyAttribute(String, String)	使用指定的組件名稱和組件位置，初始化 XmlSerializerAssemblyAttribute 類別的新執行個體。

屬性

AssemblyName	取得或設定組件的名稱，此組件中含有特定型別集合的序列化程式。
CodeBase	取得或設定包含序列化程式之組件的名稱。
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)