XmlTypeAttribute クラス


この属性が適用された対象が XmlSerializer によってシリアル化されるときに生成される XML スキーマを制御します。Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

public ref class XmlTypeAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)]
public class XmlTypeAttribute : Attribute
type XmlTypeAttribute = class
    inherit Attribute
Public Class XmlTypeAttribute
Inherits Attribute

次の例は、が適用されXmlTypeAttributeている2つのクラスを示しています。The following example shows two classes to which the XmlTypeAttribute has been applied.

public ref class Person
   String^ Name;

public ref class Address
   String^ Line1;
   String^ Line2;
   String^ City;
   String^ State;
   String^ Zip;

public ref class Group
   Person^ Manager;
   Address^ Location;

[XmlType(Namespace = "http://www.cpandl.com",
TypeName = "GroupMember")]
public class Person
   public string Name;

[XmlType(Namespace = "http://www.cohowinery.com",
TypeName = "GroupAddress")]
public class Address
   public string Line1;
   public string Line2;
   public string City;
   public string State;
   public string Zip;

public class Group
   public Person[] Staff;
   public Person Manager;
   public Address Location;

<XmlType(Namespace := "http://www.cpandl.com", _
 TypeName := "GroupMember")> _
Public Class Person
    Public Name As String
End Class

<XmlType(Namespace := "http://www.cohowinery.com", _
 TypeName := "GroupAddress")> _ 
Public Class Address
    Public Line1 As String
    Public Line2 As String
    Public City As String
    Public State As String
    Public Zip As String
End Class

Public Class Group
    Public Staff() As Person
    Public Manager As Person
    Public Location As Address
End Class


XmlTypeAttribute 、がXmlSerializerオブジェクトをシリアル化または逆シリアル化する方法を制御する属性のファミリに属しています。The XmlTypeAttribute belongs to a family of attributes that controls how the XmlSerializer serializes or deserializes an object. 類似する属性の完全な一覧については、「 XML シリアル化を制御する属性」を参照してください。For a complete list of similar attributes, see Attributes That Control XML Serialization.

クラス、構造体XmlTypeAttribute 、列挙型、またはインターフェイス宣言にを適用できます。You can apply the XmlTypeAttribute to a class, structure, enumeration, or interface declaration.

をクラスXmlTypeAttributeに適用して、xml 型の名前空間、xml 型の名前、および xml スキーマドキュメントに型を含めるかどうかを指定します。Apply the XmlTypeAttribute to a class to specify the XML type's namespace, the XML type name, and whether to include the type in the XML schema document. XmlTypeAttributeクラスのプロパティを設定した結果を表示するには、実行可能ファイルまたは DLL としてアプリケーションをコンパイルし、生成されたファイルをXML スキーマ定義ツール (xsd.exe)に渡します。To see the results of setting the properties of the XmlTypeAttribute class, compile your application as an executable or DLL, and pass the resulting file to the XML Schema Definition Tool (Xsd.exe). このツールは、型定義を含むスキーマを書き込みます。The tool writes the schema, including the type definition.


IncludeInSchemaプロパティをにfalse設定すると、 XML スキーマ定義ツール (xsd.exe)にスキーマの型が含まれません。If you set the IncludeInSchema property to false, the XML Schema Definition Tool (Xsd.exe) does not include the type in the schema. 既定では、各パブリッククラスについて、XSD ツールcomplexTypeによって、その型の要素が生成されます。By default, for each public class, the XSD tool generates a complexType and an element of that type.

属性の使用方法の詳細については、「属性」を参照してください。For more information about using attributes, see Attributes.


XmlType 長いXmlTypeAttributeのではなく、コードで単語を使用できます。You can use the word XmlType in your code instead of the longer XmlTypeAttribute.



XmlTypeAttribute クラスの新しいインスタンスを初期化します。Initializes a new instance of the XmlTypeAttribute class.


XmlTypeAttribute クラスの新しいインスタンスを初期化し、XML 型の名前を指定します。Initializes a new instance of the XmlTypeAttribute class and specifies the name of the XML type.



結果のスキーマ型が XSD 匿名型であるかどうかを判断する値を取得または設定します。Gets or sets a value that determines whether the resulting schema type is an XSD anonymous type.


XML スキーマ ドキュメントに型を含めるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether to include the type in XML schema documents.


XML 型の名前空間を取得または設定します。Gets or sets the namespace of the XML type.


派生クラスで実装されると、この Attribute の一意の識別子を取得します。When implemented in a derived class, gets a unique identifier for this Attribute.

(継承元 Attribute)

XML 型の名前を取得または設定します。Gets or sets the name of the XML type.



このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to a specified object.

(継承元 Attribute)

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

(継承元 Attribute)

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(継承元 Attribute)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(継承元 Attribute)

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)


_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。Retrieves the type information for an object, which can be used to get the type information for an interface.

(継承元 Attribute)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(継承元 Attribute)