Partilhar via


XmlTypeAttribute Classe

Definição

Controla o esquema XML que é gerado quando o atributo de destino é 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 a seguir mostra duas classes às quais a XmlTypeAttribute aplicação foi aplicada.


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


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

public ref class Group
{
public:
   array<Person^>^Staff;
   Person^ Manager;
   Address^ Location;
};
[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

Comentários

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

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

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

Observação

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

Para obter mais informações sobre como usar atributos, consulte Atributos.

Observação

Você pode usar a palavra XmlType em seu código em vez de mais tempo XmlTypeAttribute.

Construtores

XmlTypeAttribute()

Inicializa uma nova instância da classe XmlTypeAttribute.

XmlTypeAttribute(String)

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

Propriedades

AnonymousType

Obtém ou define um valor que determina se o tipo de esquema resultante é um tipo anônimo XSD.

IncludeInSchema

Obtém ou define um valor que indica se deve incluir o tipo nos XML Schema Documents.

Namespace

Obtém ou define o namespace do tipo XML.

TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.

(Herdado de Attribute)
TypeName

Obtém ou define o nome do tipo XML.

Métodos

Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
GetHashCode()

Retorna o código hash para a instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
Match(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

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

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

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

Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

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

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

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

(Herdado de Attribute)

Aplica-se a

Confira também