XmlTypeAttribute Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
- 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) |