OptionalFieldAttribute 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.
Especifica que pode faltar um campo num fluxo de serialização, de modo que o BinaryFormatter e não SoapFormatter lança uma exceção.
public ref class OptionalFieldAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class OptionalFieldAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)]
public sealed class OptionalFieldAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type OptionalFieldAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Field, Inherited=false)>]
type OptionalFieldAttribute = class
inherit AttributePublic NotInheritable Class OptionalFieldAttribute
Inherits Attribute- Herança
- Atributos
Observações
Este atributo permite-lhe especificar que novos campos num tipo serializável (um tipo ao qual o SerializableAttribute é aplicado) são ignorados pelo BinaryFormatter ou pelo SoapFormatter. Isto permite a serialização tolerante à versão dos tipos criados para versões mais antigas de uma aplicação que serializa dados. Por exemplo, quando os formateadores encontram um fluxo produzido por uma versão que não inclui os novos campos, não é lançada nenhuma exceção, e os dados existentes no tipo mais antigo são processados normalmente.
Construtores
| Name | Description |
|---|---|
| OptionalFieldAttribute() |
Inicializa uma nova instância da OptionalFieldAttribute classe. |
Propriedades
| Name | Description |
|---|---|
| TypeId |
Quando implementado numa classe derivada, obtém um identificador único para esta Attribute. (Herdado de Attribute) |
| VersionAdded |
Recebe ou define um número de versão para indicar quando o campo opcional foi adicionado. |
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) |