XmlArrayItemAttribute.Form Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, которое указывает, является ли имя сгенерированного элемента XML полным.
public:
property System::Xml::Schema::XmlSchemaForm Form { System::Xml::Schema::XmlSchemaForm get(); void set(System::Xml::Schema::XmlSchemaForm value); };
public System.Xml.Schema.XmlSchemaForm Form { get; set; }
member this.Form : System.Xml.Schema.XmlSchemaForm with get, set
Public Property Form As XmlSchemaForm
Значение свойства
Одно из значений перечисления XmlSchemaForm. Значение по умолчанию — XmlSchemaForm.None.
Исключения
Примеры
В следующем примере свойству FormVehicle класса XmlSchemaForm.Unqualifiedприсваивается значение , а свойству FormCar класса — значение XmlSchemaForm.Qualified.
public class Transportation
{
[XmlArray("Vehicles")]
// Specifies the Form property value.
[XmlArrayItem(typeof(Vehicle),
Form = XmlSchemaForm.Unqualified),
XmlArrayItem(typeof(Car),
Form = XmlSchemaForm.Qualified)]
public Vehicle[] MyVehicles;
}
public class Vehicle
{
public string id;
}
public class Car:Vehicle
{
public string Maker;
}
Public Class Transportation
' Specify the Form property value.
<XmlArray("Vehicles"), _
XmlArrayItem(GetType(Vehicle), Form := XmlSchemaForm.Unqualified), _
XmlArrayItem(GetType(Car), Form := XmlSchemaForm.Qualified)> _
Public MyVehicles() As Vehicle
End Class
Public Class Vehicle
Public id As String
End Class
Public Class Car
Inherits Vehicle
Public Maker As String
End Class
Комментарии
Свойство Form определяет, является ли имя XML-элемента квалифицированным, на основе спецификации Консорциума World Wide Web , пространства имен в XML.
Если свойству Namespace присвоено любое значение, попытка задать свойству FormXmlSchemaForm.Unqualified значение вызывает исключение.
Значение XmlSchemaForm.Noneпо умолчанию указывает XmlSerializer , чтобы проверить схему XML-документа, чтобы определить, является ли пространство имен квалифицированным. Для элементов XmlSerializer проверяет значение атрибута elementFormDefaultschema-element . Для атрибутов проверяется значение атрибута attributeFormDefaultschema-element . Например, следующая схема XML указывает, что Name элемент является квалифицированным, а Number элемент не квалифицирован.
<schema elementFormDefault="qualified"
attributeFormDefault="unqualified">
<element name="Name"/>
<attribute name="Number"/>
</schema>