XmlTypeAttribute Klasa

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.XmlSerializer.dll

Steruje schematem XML generowanym, gdy obiekt docelowy atrybutu jest serializowany przez element 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

Dziedziczenie

Object

Attribute

XmlTypeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie przedstawiono dwie klasy, do których zastosowano klasę XmlTypeAttribute .

[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

Uwagi

Element XmlTypeAttribute należy do rodziny atrybutów, które kontrolują sposób XmlSerializer serializacji lub deserializacji obiektu. Aby uzyskać pełną listę podobnych atrybutów, zobacz Atrybuty, które kontrolują serializacji XML.

Można zastosować element XmlTypeAttribute do klasy, struktury, wyliczenia lub deklaracji interfejsu.

Zastosuj element XmlTypeAttribute do klasy, aby określić przestrzeń nazw typu XML, nazwę typu XML i określić, czy typ ma być uwzględniny w dokumencie schematu XML. Aby wyświetlić wyniki ustawiania właściwości XmlTypeAttribute klasy, skompiluj aplikację jako plik wykonywalny lub DLL i przekaż wynikowy plik do narzędzia definicji schematu XML (Xsd.exe). Narzędzie zapisuje schemat, w tym definicję typu.

Uwaga

Jeśli właściwość zostanie ustawiona IncludeInSchema na false, narzędzie definicji schematu XML (Xsd.exe) nie zawiera typu w schemacie. Domyślnie dla każdej klasy publicznej narzędzie XSD generuje complexType element i tego typu.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.

Uwaga

Możesz użyć słowa XmlType w kodzie zamiast dłuższego XmlTypeAttribute.

Konstruktory

XmlTypeAttribute()	Inicjuje nowe wystąpienie klasy XmlTypeAttribute.
XmlTypeAttribute(String)	Inicjuje XmlTypeAttribute nowe wystąpienie klasy i określa nazwę typu XML.

Właściwości

AnonymousType	Pobiera lub ustawia wartość, która określa, czy wynikowy typ schematu jest typem anonimowym XSD.
IncludeInSchema	Pobiera lub ustawia wartość wskazującą, czy należy uwzględnić typ w dokumentach schematu XML.
Namespace	Pobiera lub ustawia przestrzeń nazw typu XML.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)
TypeName	Pobiera lub ustawia nazwę typu XML.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• Wprowadzenie do serializacji XML
• Instrukcje: Określanie alternatywnej nazwy elementu dla strumienia XML
• Kontrolowanie serializacji XML przy użyciu atrybutów
• Przykłady serializacji XML