XmlTypeAttribute クラス

定義

名前空間:

System.Xml.Serialization

アセンブリ:

netstandard.dll, System.Xml.XmlSerializer.dll

ソース:

XmlTypeAttribute.cs

属性ターゲットが XmlSerializerによってシリアル化されるときに生成される XML スキーマを制御します。

public ref class XmlTypeAttribute : Attribute

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

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

Public Class XmlTypeAttribute
Inherits Attribute

継承

Object

Attribute

XmlTypeAttribute

属性

AttributeUsageAttribute

例

次の例は、 XmlTypeAttribute が適用されている 2 つのクラスを示しています。

[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がオブジェクトをシリアル化または逆シリアル化する方法を制御する属性のファミリに属しています。 類似する属性の完全な一覧については、「 XML シリアル化を制御する属性」を参照してください。

XmlTypeAttributeは、クラス、構造体、列挙型、またはインターフェイス宣言に適用できます。

XmlTypeAttributeをクラスに適用して、XML 型の名前空間、XML 型名、および XML スキーマ ドキュメントに型を含めるかどうかを指定します。 XmlTypeAttribute クラスのプロパティを設定した結果を確認するには、実行可能ファイルまたは DLL としてアプリケーションをコンパイルし、結果のファイルを XML スキーマ定義ツール (Xsd.exe) に渡します。 このツールは、型定義を含むスキーマを書き込みます。

注

IncludeInSchema プロパティを false に設定すると、XML スキーマ定義ツール (Xsd.exe) にはスキーマに型が含まれません。 既定では、各パブリック クラスに対して、XSD ツールによって complexType とその型の要素が生成されます。

属性の使用の詳細については、「 属性」を参照してください。

注

コードでは、長いXmlTypeAttributeではなく、XmlTypeという単語を使用できます。

コンストラクター

名前	説明
XmlTypeAttribute()	XmlTypeAttribute クラスの新しいインスタンスを初期化します。
XmlTypeAttribute(String)	XmlTypeAttribute クラスの新しいインスタンスを初期化し、XML 型の名前を指定します。

プロパティ

名前	説明
AnonymousType	結果のスキーマ型が XSD 匿名型かどうかを決定する値を取得または設定します。
IncludeInSchema	XML スキーマ ドキュメントに型を含めるかどうかを示す値を取得または設定します。
Namespace	XML 型の名前空間を取得または設定します。
TypeId	派生クラスで実装されている場合は、この Attributeの一意の識別子を取得します。 (継承元 Attribute)
TypeName	XML 型の名前を取得または設定します。

メソッド

名前	説明
Equals(Object)	このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute)
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 Attribute)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	派生クラスでオーバーライドされた場合、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute)
Match(Object)	派生クラスでオーバーライドされた場合、このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• XML シリアル化の概要
• 方法: XML ストリームの代替要素名を指定する
• 属性を使用した XML シリアル化の制御
• XML シリアル化の例