XmlArrayItemAttribute.Form Propriedade

Definição

Espaço de Nomes:
System.Xml.Serialization
Assemblagens:
System.Xml.dll, System.Xml.XmlSerializer.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Obtém ou define um valor que indica se o nome do elemento XML gerado é qualificado.

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

Valor de Propriedade

XmlSchemaForm

Um dos XmlSchemaForm valores. A predefinição é XmlSchemaForm.None.

Exceções

Exception

A Form propriedade é definida como XmlSchemaForm.Unqualified e um Namespace valor é especificado.

Exemplos

O exemplo seguinte estabelece a Form propriedade da Vehicle classe para XmlSchemaForm.Unqualified, e a Form propriedade da Car classe para 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

Observações

A Form propriedade determina se um nome de elemento XML é qualificado, com base na especificação Namespaces do World Wide Web Consortium em XML.

Se a Namespace propriedade for definida para qualquer valor, tentar definir a Form propriedade XmlSchemaForm.Unqualified para lança uma exceção.

O valor predefinido, XmlSchemaForm.None, instrui o XmlSerializer a verificar o esquema do documento XML para determinar se o namespace é qualificado. Para os elementos, verifica XmlSerializer o valor do atributo elementFormDefaultelemento do esquema . Para atributos, verifica o valor do atributo attributeFormDefaultelemento do esquema . Por exemplo, o seguinte Esquema XML indica que o Name elemento é qualificado, enquanto o Number elemento é não qualificado.

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

Aplica-se a