XmlSerializerAssemblyAttribute クラス

.NET Framework クラス ライブラリ リファレンス

XmlSerializerAssemblyAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Web サービス クライアント プロキシに適用すると、カスタム メイドのシリアライザを含むアセンブリを指定できます。

名前空間: System.Xml.Serialization
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Struct
 Or AttributeTargets.Enum Or AttributeTargets.Interface,
 AllowMultiple:=False)> _
Public NotInheritable Class
 XmlSerializerAssemblyAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As XmlSerializerAssemblyAttribute

C#

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

C++

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

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Interface,
 AllowMultiple=false) */ 
public final class XmlSerializerAssemblyAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Enum|AttributeTargets.Interface,
 AllowMultiple=false) 
public final class XmlSerializerAssemblyAttribute
 extends Attribute

解説

XmlSerializerAssemblyAttribute を使用すると、Web サービス クライアント アプリケーションのパフォーマンスを向上させることができます。

この属性は、通常、次のように使用します。

1. Web サービスのクライアント プロキシを作成します。

2. machine.config ファイルを開きます。

3. system.diagnostics 要素の下の <switches> 要素の下に、コンパイルしたファイルを保持するための値を追加します。

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

4. プロキシをコンパイルします。

5. プロキシ アプリケーションを実行します。

6. コマンド ウィンドウを開いて、XmlSerializer が使用する \Temp ディレクトリに移動し、ファイルをキャッシュします。

   cd %temp%

7. /OD スイッチ付きの dir コマンドを使用して、最後に作成されたファイルを検出します。

   dir *.vb /OD 

8. ファイルをアセンブリにコンパイルします。アセンブリの名前を指定します。

9. XmlSerializerAssemblyAttribute をクラスに適用して、元のプロキシ コードを編集します。次の C# コードのように、アセンブリ名を指定します。

   C#

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

Visual Basic

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

継承階層

System.Object
   System.Attribute
    System.Xml.Serialization.XmlSerializerAssemblyAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XmlSerializerAssemblyAttribute メンバ
System.Xml.Serialization 名前空間