XmlTypeAttribute Classe

Definição

Controla o esquema XML que é gerado quando o destino do atributo é serializado pelo XmlSerializer.

public ref class XmlTypeAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)]
public class XmlTypeAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Enum | System.AttributeTargets.Interface | System.AttributeTargets.Struct)>]
type XmlTypeAttribute = class
    inherit Attribute
Public Class XmlTypeAttribute
Inherits Attribute
Herança
XmlTypeAttribute
Atributos

Exemplos

O exemplo seguinte mostra duas classes às quais o XmlTypeAttribute foi aplicado.

[XmlType(Namespace = "http://www.cpandl.com",
TypeName = "GroupMember")]
public class Person
{
   public string Name;
}

[XmlType(Namespace = "http://www.cohowinery.com",
TypeName = "GroupAddress")]
public class Address
{
   public string Line1;
   public string Line2;
   public string City;
   public string State;
   public string Zip;
}

public class Group
{
   public Person[] Staff;
   public Person Manager;
   public Address Location;
}
<XmlType(Namespace := "http://www.cpandl.com", _
 TypeName := "GroupMember")> _
Public Class Person
    Public Name As String
End Class

<XmlType(Namespace := "http://www.cohowinery.com", _
 TypeName := "GroupAddress")> _ 
Public Class Address
    
    Public Line1 As String
    Public Line2 As String
    Public City As String
    Public State As String
    Public Zip As String
End Class

Public Class Group
    Public Staff() As Person
    Public Manager As Person
    Public Location As Address
End Class

Observações

Pertence XmlTypeAttribute a uma família de atributos que controla como serializa XmlSerializer ou desserializa um objeto. Para obter uma lista completa de atributos semelhantes, consulte Atributos que controlam a serialização XML.

Podes aplicar o XmlTypeAttribute a uma declaração de classe, estrutura, enumeração ou interface.

Aplique a XmlTypeAttribute uma classe para especificar o namespace do tipo XML, o nome do tipo XML e se deve incluir o tipo no documento de esquema XML. Para ver os resultados da definição das propriedades da XmlTypeAttribute classe, compile a sua aplicação como executável ou DLL, e passe o ficheiro resultante para a Ferramenta de Definição de Esquema XML (Xsd.exe). A ferramenta escreve o esquema, incluindo a definição do tipo.

Note

Se definir a IncludeInSchema propriedade para false, a Ferramenta de Definição de Esquema XML (Xsd.exe) não inclui o tipo no esquema. Por defeito, para cada classe pública, a ferramenta XSD gera um complexType e um elemento desse tipo.

Para mais informações sobre o uso de atributos, consulte Atributos.

Note

Podes usar a palavra XmlType no teu código em vez do mais longo XmlTypeAttribute.

Construtores

Name Description
XmlTypeAttribute()

Inicializa uma nova instância da XmlTypeAttribute classe.

XmlTypeAttribute(String)

Inicializa uma nova instância da XmlTypeAttribute classe e especifica o nome do tipo XML.

Propriedades

Name Description
AnonymousType

Recebe ou define um valor que determina se o tipo de esquema resultante é um tipo anónimo XSD.

IncludeInSchema

Recebe ou define um valor que indica se deve incluir o tipo em documentos de esquema XML.

Namespace

Obtém ou define o namespace do tipo XML.

TypeId

Quando implementado numa classe derivada, obtém um identificador único para esta Attribute.

(Herdado de Attribute)
TypeName

Obtém ou define o nome do tipo XML.

Métodos

Name Description
Equals(Object)

Devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
GetHashCode()

Devolve o código de hash para esta instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando sobrescrito numa classe derivada, indica se o valor desta instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando sobrescrito numa classe derivada, devolve um valor que indica se esta instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de despacho.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera a informação de tipo de um objeto, que pode ser usada para obter a informação de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera o número de interfaces de informações de tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a

Ver também