XmlArrayItemAttribute.Form Właściwość

Definicja

Przestrzeń nazw:

System.Xml.Serialization

Zestaw:

System.Xml.XmlSerializer.dll

Źródło:

XmlArrayItemAttribute.cs

Pobiera lub ustawia wartość wskazującą, czy nazwa wygenerowanego elementu XML jest kwalifikowana.

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

Wartość właściwości

XmlSchemaForm

XmlSchemaForm Jedna z wartości. Wartość domyślna to XmlSchemaForm.None.

Wyjątki

Exception

Właściwość jest ustawiona Form na XmlSchemaForm.Unqualified , a wartość jest określona Namespace .

Przykłady

W poniższym przykładzie Form właściwość klasy Vehicle jest ustawiana na XmlSchemaForm.Unqualified, a Form właściwość klasy Car na 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

Uwagi

Właściwość Form określa, czy nazwa elementu XML jest kwalifikowana, na podstawie przestrzeni nazw specyfikacji World Wide Web Consortium w formacie XML.

Namespace Jeśli właściwość jest ustawiona na dowolną wartość, próba ustawienia Form właściwości w celu XmlSchemaForm.Unqualified zgłoszenia wyjątku.

Wartość domyślna , XmlSchemaForm.Nonepowoduje sprawdzenie XmlSerializer schematu dokumentu XML w celu określenia, czy przestrzeń nazw jest kwalifikowana. W przypadku elementów funkcja XmlSerializer sprawdza wartość atrybutu elementFormDefaultschema-element . W przypadku atrybutów sprawdza wartość atrybutu attributeFormDefaultschema-element . Na przykład poniższy schemat XML wskazuje, że Name element jest kwalifikowany, podczas gdy Number element jest niekwalifikowany.

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