XmlArrayItemAttribute.Form Vlastnost

Definice

Obor názvů:

System.Xml.Serialization

Sestavení:

netstandard.dll, System.Xml.XmlSerializer.dll

Zdroj:

XmlArrayItemAttribute.cs

Získá nebo nastaví hodnotu, která určuje, zda je název vygenerovaného xml elementu kvalifikovaný.

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

Hodnota vlastnosti

XmlSchemaForm

Jedna z XmlSchemaForm hodnot. Výchozí hodnota je XmlSchemaForm.None.

Výjimky

Exception

Vlastnost je nastavena FormXmlSchemaForm.Unqualified a Namespace je zadána hodnota.

Příklady

Následující příklad nastaví Form vlastnost třídy Vehicle na XmlSchemaForm.Unqualifieda Form vlastnost třídy Car na 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

Poznámky

Vlastnost Form určuje, zda je název elementu XML kvalifikovaný, na základě specifikace World Wide Web Consortium Obory názvů v XML.

Namespace Pokud je vlastnost nastavena na libovolnou hodnotu, pokus o nastavení Form vlastnosti XmlSchemaForm.Unqualified vyvolá výjimku.

Výchozí hodnota , XmlSchemaForm.Nonedává pokyn XmlSerializer ke kontrole schématu dokumentu XML určit, zda je obor názvů kvalifikovaný. U elementů zkontroluje XmlSerializer hodnotu atributu elementFormDefaultschema-element . U atributů kontroluje hodnotu atributu attributeFormDefaultschema-element . Například následující schéma XML označuje, že Name element je kvalifikovaný, zatímco Number element je nekvalifikovaný.

<schema elementFormDefault="qualified"
attributeFormDefault="unqualified">
   <element name="Name"/>
   <attribute name="Number"/>
</schema>