XmlTypeAttribute Класс

Определение

Пространство имен:

System.Xml.Serialization

Сборка:

System.Xml.XmlSerializer.dll

Исходный код:

XmlTypeAttribute.cs

Управляет схемой XML, которая создается при сериализации конечного объекта атрибута классом 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

Наследование

Object

Attribute

XmlTypeAttribute

Атрибуты

AttributeUsageAttribute

Примеры

В следующем примере показаны два класса, к которым 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

Комментарии

принадлежит XmlTypeAttribute к семейству атрибутов, которые управляют тем, как XmlSerializer сериализует или десериализует объект. Полный список аналогичных атрибутов см. в разделе Атрибуты, управляющие сериализацией XML.

Можно применить к классу XmlTypeAttribute , структуре, перечислению или объявлению интерфейса.

XmlTypeAttribute Примените к классу, чтобы указать пространство имен типа XML, имя типа XML и необходимость включения типа в документ схемы XML. Чтобы просмотреть результаты задания свойств XmlTypeAttribute класса, скомпилируйте приложение в виде исполняемого файла или библиотеки DLL и передайте полученный файл в средство определения схемы XML (Xsd.exe). Средство записывает схему, включая определение типа.

Примечание

Если для свойства задано значение IncludeInSchemafalse, средство определения схемы XML (Xsd.exe) не включает тип в схему. По умолчанию для каждого открытого класса средство XSD создает complexType и элемент этого типа.

Дополнительные сведения об использовании атрибутов см. в разделе Атрибуты.

Примечание

Вы можете использовать слово XmlType в коде вместо более длинного XmlTypeAttribute.

Конструкторы

XmlTypeAttribute()	Инициализирует новый экземпляр класса XmlTypeAttribute.
XmlTypeAttribute(String)	Инициализирует новый экземпляр класса XmlTypeAttribute и задает имя типа XML.

Свойства

AnonymousType	Возвращает или задает значение, определяющее, является ли результирующий тип схемы анонимным типом XSD.
IncludeInSchema	Возвращает или задает значение, указывающее, следует ли включать тип в документы схемы XML.
Namespace	Возвращает или задает пространство имен типа XML.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)
TypeName	Возвращает или задает имя типа XML.

Методы

Equals(Object)	Возвращает значение, показывающее, равен ли экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код данного экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• XmlAttributeOverrides
• XmlAttributes
• XmlSerializer
• XmlText
• Введение в сериализацию XML
• Практическое руководство. Указание имени альтернативного элемента для потока XML
• Управление сериализацией XML с использованием атрибутов
• Примеры сериализации XML