XmlArrayItemAttribute.Form Свойство

Определение

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

System.Xml.Serialization

Сборки:

netstandard.dll, System.Xml.XmlSerializer.dll

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

XmlArrayItemAttribute.cs

Возвращает или задает значение, указывающее, является ли имя созданного 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 . Значение по умолчанию — XmlSchemaForm.None.

Исключения

Exception

Для Form свойства задано XmlSchemaForm.Unqualified значение и Namespace указано значение.

Примеры

В следующем примере свойство класса XmlSchemaForm.UnqualifiedVehicle присваивается Form , а Form свойство для Car класса — 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 Consortium в XML.

Namespace Если для свойства задано любое значение, попытка задать Form для свойства XmlSchemaForm.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>