XmlTypeAttribute Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет 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
- Наследование
- Атрибуты
Примеры
В следующем примере показаны два класса, к которым 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) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute) |