IFormatter Interface

Referência

Definição

Namespace:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.Formatters.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cuidado

BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.

Fornece a funcionalidade para formatação de objetos serializados.

public interface class IFormatter

public interface IFormatter

[System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public interface IFormatter

[System.Runtime.InteropServices.ComVisible(true)]
public interface IFormatter

type IFormatter = interface

[<System.Obsolete("BinaryFormatter serialization is obsolete and should not be used. See https://aka.ms/binaryformatter for more information.", DiagnosticId="SYSLIB0011", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type IFormatter = interface

[<System.Runtime.InteropServices.ComVisible(true)>]
type IFormatter = interface

Public Interface IFormatter

Derivado: System.Runtime.Remoting.Messaging.IRemotingFormatter

System.Runtime.Serialization.Formatter

System.Runtime.Serialization.Formatters.Binary.BinaryFormatter

System.Runtime.Serialization.Formatters.Soap.SoapFormatter

System.Runtime.Serialization.NetDataContractSerializer

Mais…

Atributos: ObsoleteAttribute ComVisibleAttribute

Comentários

Essa interface deve ser implementada por qualquer classe identificada como um formatador na System.Runtime.Serialization arquitetura.

Os objetos que controlam sua própria serialização podem fazer isso implementando a ISerializable interface . Para que um objeto seja serializado, você deve marcar esse objeto como serializável. Você pode fazer isso aplicando o atributo serializável a uma classe . Se qualquer objeto no grafo não for serializável, a serialização falhará.

Notas aos Implementadores

Todos os formatadores devem implementar essa interface. Use Serialize(Stream, Object) para serializar um objeto ou grafo de objetos. Use Deserialize(Stream) para desserializar um fluxo e criar um clone do objeto original ou grafo de objetos.

Propriedades

Binder	Obsoleto. Obtém ou define o SerializationBinder que executa pesquisas de tipo durante a desserialização.
Context	Obsoleto. Obtém ou define o StreamingContext usado para serialização e desserialização.
SurrogateSelector	Obsoleto. Obtém ou define o SurrogateSelector usado pelo formatador atual.

Métodos

Deserialize(Stream)	Obsoleto. Desserializa os dados no fluxo fornecido e reconstitui o grafo de objetos.
Serialize(Stream, Object)	Obsoleto. Serializa um objeto ou grafo de objetos com a raiz especificada para o fluxo fornecido.

Aplica-se a

Produto	Versões (Obsoleto)
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Partilhar via