XmlTypeAttribute Osztály

Definíció

Névtér:

System.Xml.Serialization

Szerelvények:

netstandard.dll, System.Xml.XmlSerializer.dll

Forrás:

XmlTypeAttribute.cs

Az attribútum-cél szerializálásakor létrehozott XML-sémát szabályozza.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

Öröklődés

Object

Attribute

XmlTypeAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa két osztályt mutat be, amelyekre a XmlTypeAttribute rendszer alkalmazva lett.

[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

Megjegyzések

Az XmlTypeAttribute attribútumcsalád az objektum szerializálásának vagy deszerializálásának módját szabályozza XmlSerializer . A hasonló attribútumok teljes listáját az XML-szerializálást vezérlő attribútumok című témakörben találja.

Alkalmazhatja az XmlTypeAttribute osztályra, struktúrára, enumerálásra vagy felületdeklarációra.

Alkalmazza az XmlTypeAttribute osztályt az XML-típus névterének, az XML-típus nevének és annak megadására, hogy a típus szerepeljen-e az XML-sémadokumentumban. Az osztály tulajdonságainak beállításának XmlTypeAttribute eredményeinek megtekintéséhez állítsa össze az alkalmazást végrehajtható vagy DLL-fájlként, és adja át az eredményként kapott fájlt az XML-sémadefiníciós eszköznek (Xsd.exe). Az eszköz megírja a sémát, beleértve a típusdefiníciót is.

Note

Ha a tulajdonságot úgy IncludeInSchema állítja be, hogy falseaz XML-sémadefiníciós eszköz (Xsd.exe) nem tartalmazza a típust a sémában. Az XSD-eszköz alapértelmezés szerint minden nyilvános osztályhoz létrehoz egy complexType és egy ilyen típusú elemet.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Note

A hosszabb helyett használhatja a szót XmlType a XmlTypeAttributekódban.

Konstruktorok

Name	Description
XmlTypeAttribute()	Inicializálja a XmlTypeAttribute osztály új példányát.
XmlTypeAttribute(String)	Inicializálja az XmlTypeAttribute osztály új példányát, és megadja az XML-típus nevét.

Tulajdonságok

Name	Description
AnonymousType	Lekéri vagy beállít egy értéket, amely meghatározza, hogy az eredményül kapott sématípus XSD névtelen típus-e.
IncludeInSchema	Lekéri vagy beállít egy értéket, amely jelzi, hogy a típus szerepel-e az XML-sémadokumentumokban.
Namespace	Lekéri vagy beállítja az XML-típus névterét.
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)
TypeName	Lekéri vagy beállítja az XML-típus nevét.

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• Az XML-szerializálás bemutatása
• Útmutató: Alternatív elemnév megadása XML-adatfolyamhoz
• XML-szerializálás szabályozása attribútumokkal
• Példák XML-szerializálásra