XmlArrayItemAttribute.Form Свойство

Определение

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

System.Xml.Serialization

Сборка:

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 задано.

Примеры

В следующем примере свойству FormVehicle класса XmlSchemaForm.Unqualifiedприсваивается значение , а свойству FormCar класса — значение XmlSchemaForm.Qualified.

public ref class Vehicle
{
public:
   String^ id;
};

public ref class Car: public Vehicle
{
public:
   String^ Maker;
};

public ref class Transportation
{
public:

   // Specifies the Form property value.

   [XmlArray("Vehicles")]
   [XmlArrayItem(Vehicle::typeid,
   Form=XmlSchemaForm::Unqualified),
   XmlArrayItem(Car::typeid,
   Form=XmlSchemaForm::Qualified)]
   array<Vehicle^>^MyVehicles;
};

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>