Freigeben über

XmlTypeAttribute Klasse

Definition

Namespace:
System.Xml.Serialization
Assemblys:
System.Xml.dll, System.Xml.XmlSerializer.dll
Assemblys:
netstandard.dll, System.Xml.XmlSerializer.dll
Assembly:
System.Xml.XmlSerializer.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XmlTypeAttribute.cs
Quelle:
XmlTypeAttribute.cs
Quelle:
XmlTypeAttribute.cs
Quelle:
XmlTypeAttribute.cs
Quelle:
XmlTypeAttribute.cs

Steuert das XML-Schema, das generiert wird, wenn das Attributziel vom XmlSerializerserialisiert 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 die XmlTypeAttribute Anwendung erfolgt ist.

[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

Dies XmlTypeAttribute gehört zu einer Familie von Attributen, die steuert, wie das XmlSerializer Serialisieren oder Deserialisieren eines Objekts. Eine vollständige Liste ähnlicher Attribute finden Sie unter Attributes That Control XML Serialization.

Sie können die XmlTypeAttribute Klasse, Struktur, Aufzählung oder Schnittstellendeklaration anwenden.

Wenden Sie die XmlTypeAttribute Klasse auf eine Klasse an, um den Namespace des XML-Typs, den XML-Typnamen und den Typ im XML-Schemadokument anzugeben. 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, enthält das XML-Schemadefinitionstool (Xsd.exe) nicht den Typ im Schema. 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 in Ihrem Code anstelle der längeren XmlTypeAttributeVerwenden.

Konstruktoren

Name Beschreibung
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

Name Beschreibung
AnonymousType

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob der resultierende Schematyp ein anonymer XSD-Typ ist.
IncludeInSchema

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Typ in XML-Schemadokumente eingeschlossen werden soll.
Namespace

Ruft den Namespace des XML-Typs ab oder legt den Namespace fest.
TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)
TypeName

Dient zum Abrufen oder Festlegen des Namens des XML-Typs.

Methoden

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

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

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen