XmlTypeAttribute Třída

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.XmlSerializer.dll

Zdroj:

XmlTypeAttribute.cs

Řídí schéma XML, které je generováno, když cíl atributu je serializován XmlSerializer.

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

Dědičnost

Object

Attribute

XmlTypeAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad ukazuje dvě třídy, na které XmlTypeAttribute byla použita.

[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

Poznámky

Patří XmlTypeAttribute do řady atributů, které řídí, jak XmlSerializer serializuje nebo deserializuje objekt. Úplný seznam podobných atributů naleznete v části Atributy, které řídí serializaci XML.

Můžete použít XmlTypeAttribute na třídu, strukturu, výčet nebo deklaraci rozhraní.

XmlTypeAttribute Použijte u třídy k určení oboru názvů typu XML, názvu typu XML a zda se má zahrnout typ do dokumentu schématu XML. Pokud chcete zobrazit výsledky nastavení vlastností XmlTypeAttribute třídy, zkompilujte aplikaci jako spustitelný soubor nebo knihovnu DLL a předejte výsledný soubor nástroji definice schématu XML (Xsd.exe). Nástroj zapíše schéma, včetně definice typu.

Poznámka:

Pokud nastavíte IncludeInSchema vlastnost falsena , nástroj definice schématu XML (Xsd.exe) nezahrnuje typ ve schématu. Ve výchozím nastavení pro každou veřejnou třídu nástroj XSD generuje complexType a prvek tohoto typu.

Další informace o používání atributů naleznete v tématu Atributy.

Poznámka:

Místo delšího XmlTypeAttributekódu můžete použít slovo XmlType v kódu .

Konstruktory

Name	Description
XmlTypeAttribute()	Inicializuje novou instanci XmlTypeAttribute třídy.
XmlTypeAttribute(String)	Inicializuje novou instanci XmlTypeAttribute třídy a určuje název typu XML.

Vlastnosti

Name	Description
AnonymousType	Získá nebo nastaví hodnotu, která určuje, zda výsledný typ schématu je XSD anonymní typ.
IncludeInSchema	Získá nebo nastaví hodnotu, která určuje, zda zahrnout typ do dokumentů schématu XML.
Namespace	Získá nebo nastaví obor názvů typu XML.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute)
TypeName	Získá nebo nastaví název typu XML.

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí kód hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• Představujeme serializaci XML
• Postupy: Určení alternativního názvu elementu pro datový proud XML
• Řízení serializace XML pomocí atributů
• Příklady serializace XML