XmlAttributeAttribute.Form Propriedade

Definição

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtém ou define um valor que indica se o nome do atributo XML gerado pelo XmlSerializer é 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 da propriedade

XmlSchemaForm

Um dos valores de XmlSchemaForm. O padrão é XmlForm.None.

Exemplos

O exemplo a seguir aplica-se a XmlAttributeAttribute dois campos contidos em uma classe.

public ref class Vehicle
{
public:

   [XmlAttributeAttribute(Form=XmlSchemaForm::Qualified)]
   String^ Maker;

   [XmlAttributeAttribute(Form=XmlSchemaForm::Unqualified)]
   String^ ModelID;
};

public class Vehicle
{
   [XmlAttribute(Form = XmlSchemaForm.Qualified)]
   public string Maker;

   [XmlAttribute(Form = XmlSchemaForm.Unqualified)]
   public string ModelID;
}

Public Class Vehicle
    <XmlAttribute(Form := XmlSchemaForm.Qualified)> _
    Public Maker As String    

    <XmlAttribute(Form := XmlSchemaForm.Unqualified)> _
    Public ModelID As String
End Class

Comentários

A Form propriedade determina se um elemento XML é qualificado ou não qualificado. A Form propriedade está em conformidade com a especificação Namespaces in XMLde 1999http://www.w3.org.

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

A configuração XmlSchemaForm.Nonepadrão instrui a verificar o XmlSerializer esquema do documento XML para determinar se o namespace é qualificado. Se o esquema não especificar um valor para um elemento ou atributo individual, ele usará o e attributeFormDefault os elementFormDefault XmlSerializer valores para determinar se um elemento ou atributo é qualificado. O seguinte código XML mostra um esquema:

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

Quando o XmlSerializer esquema é lido, o Form valor para o Name e Number é XmlSchemaForm.None, mas o Name elemento é qualificado, enquanto o Number elemento não é qualificado.