XmlTypeAttribute Klasse

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Quelle:

XmlTypeAttribute.cs

Steuert das XML-Schema, das generiert wird, wenn das Attributziel vom XmlSerializer serialisiert wird.

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

Vererbung

Object

Attribute

XmlTypeAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel zeigt zwei Klassen, auf die angewendet XmlTypeAttribute wurde.

[XmlType(Namespace="http://www.cpandl.com",
TypeName="GroupMember")]
public ref class Person
{
public:
   String^ Name;
};


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

public ref class Group
{
public:
   array<Person^>^Staff;
   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

Hinweise

gehört XmlTypeAttribute zu einer Familie von Attributen, die steuern, wie ein XmlSerializer Objekt serialisiert oder deserialisiert wird. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attribute, die die XML-Serialisierung steuern.

Sie können die XmlTypeAttribute auf eine Klassen-, Struktur-, Enumerations- oder Schnittstellendeklaration anwenden.

Wenden Sie auf XmlTypeAttribute eine Klasse an, um den Namespace des XML-Typs, den XML-Typnamen und die Angabe, ob der Typ in das XML-Schemadokument eingeschlossen werden soll. Um die Ergebnisse des Festlegens der Eigenschaften der XmlTypeAttribute -Klasse anzuzeigen, kompilieren Sie Ihre Anwendung als ausführbare Datei oder DLL, und übergeben Sie die resultierende Datei an das XML-Schemadefinitionstool (Xsd.exe). Das Tool schreibt das Schema, einschließlich der Typdefinition.

Hinweis

Wenn Sie die IncludeInSchema -Eigenschaft auf falsefestlegen, schließt das XML-Schemadefinitionstool (Xsd.exe) den Typ nicht in das Schema ein. Standardmäßig generiert das XSD-Tool für jede öffentliche Klasse ein complexType - und ein Element dieses Typs.

Weitere Informationen zur Verwendung von Attributen finden Sie unter Attribute.

Hinweis

Sie können das Wort XmlType im Code anstelle des längeren XmlTypeAttributeverwenden.

Konstruktoren

XmlTypeAttribute()	Initialisiert eine neue Instanz der XmlTypeAttribute-Klasse.
XmlTypeAttribute(String)	Initialisiert eine neue Instanz der XmlTypeAttribute-Klasse und gibt den Namen des XML-Typs an.

Eigenschaften

AnonymousType	Ruft einen Wert ab, der bestimmt, ob der resultierende Schematyp ein anonymer XSD-Typ ist, oder legt diesen fest.
IncludeInSchema	Ruft einen Wert ab, der angibt, ob der Typ in XML-Schemadokumente aufgenommen werden soll, oder legt diesen fest.
Namespace	Ruft den Namespace des XML-Typs ab oder legt diesen fest.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
TypeName	Ruft den Namen des XML-Typs ab oder legt diesen fest.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• Einführung in die XML-Serialisierung
• How to: Angeben eines alternativen Elementnamens für einen XML-Stream.
• Steuern der XML-Serialisierung mit Attributen
• Beispiele für die XML-Serialisierung