XmlTypeAttribute Класс

Определение

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

System.Xml.Serialization

Сборки:

netstandard.dll, 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 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). Средство записывает схему, включая определение типа.

Замечание

Если для свойства задано IncludeInSchema значение false, средство определения схемы 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