XmlArrayItemAttribute.Form Egenskap

Definition

Hämtar eller anger ett värde som anger om namnet på det genererade XML-elementet är kvalificerat.

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

Egenskapsvärde

Ett av XmlSchemaForm värdena. Standardvärdet är XmlSchemaForm.None.

Undantag

Egenskapen Form är inställd på XmlSchemaForm.Unqualified och ett Namespace värde anges.

Exempel

I följande exempel anges Form egenskapen för Vehicle klassen till XmlSchemaForm.Unqualifiedoch Form egenskapen för Car klassen till 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

Kommentarer

Egenskapen Form avgör om ett XML-elementnamn är kvalificerat, baserat på World Wide Web Consortium-specifikationen Namnområden i XML.

Om egenskapen Namespace är inställd på något värde, försöker du ställa in Form egenskapen så att XmlSchemaForm.Unqualified den genererar ett undantag.

Standardvärdet, XmlSchemaForm.None, instruerar XmlSerializer att kontrollera schemat för XML-dokumentet för att avgöra om namnområdet är kvalificerat. För element XmlSerializer kontrollerar värdet för attributet elementFormDefaultschema-element . För attribut kontrollerar den värdet för attributet attributeFormDefaultschema-element . Följande XML-schema anger till exempel att elementet Name är kvalificerat, medan elementet Number är okvalificerat.

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

Gäller för