DataContractSerializer.ReadObject Método

Referência

Definição

Namespace:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.Xml.dll

Assembly:: System.Runtime.Serialization.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.

Lê o fluxo XML e retorna o objeto desserializado.

Sobrecargas

ReadObject(XmlReader)	Lê o fluxo XML com um XmlReader e retorna o objeto desserializado.
ReadObject(XmlDictionaryReader, Boolean)	Lê o fluxo XML com um XmlDictionaryReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor.
ReadObject(XmlReader, Boolean)	Lê o fluxo XML com um XmlReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor.
ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)	Lê um documento ou fluxo de documentos XML e retorna o objeto desserializado. O método inclui um parâmetro para especificar se o nome do objeto é verificado e validado e um resolvedor para mapear declarações `xsi:type` em runtime.

ReadObject(XmlReader)

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Lê o fluxo XML com um XmlReader e retorna o objeto desserializado.

public:
 override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader);

public override object ReadObject (System.Xml.XmlReader reader);

public override object? ReadObject (System.Xml.XmlReader reader);

override this.ReadObject : System.Xml.XmlReader -> obj

Public Overrides Function ReadObject (reader As XmlReader) As Object

Parâmetros

reader: XmlReader

O XmlReader usado para ler o fluxo XML.

Retornos

Object

O objeto desserializado.

Aplica-se a

ReadObject(XmlDictionaryReader, Boolean)

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Lê o fluxo XML com um XmlDictionaryReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor.

public:
 override System::Object ^ ReadObject(System::Xml::XmlDictionaryReader ^ reader, bool verifyObjectName);

public override object ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName);

public override object? ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName);

override this.ReadObject : System.Xml.XmlDictionaryReader * bool -> obj

Public Overrides Function ReadObject (reader As XmlDictionaryReader, verifyObjectName As Boolean) As Object

Parâmetros

reader: XmlDictionaryReader

O XmlDictionaryReader usado para ler o fluxo XML.

verifyObjectName: Boolean

true para verificar se o nome do objeto corresponde ao valor de nome raiz fornecido no construtor, caso contrário, false.

Retornos

Object

O objeto desserializado.

Exceções

SerializationException

O parâmetro verifyObjectName é definido como true e o nome do elemento e o namespace não correspondem aos valores definidos no construtor.

Exemplos

O exemplo a seguir lê um documento XML e desserializa uma instância de um objeto .

public static void ReadObject(string fileName)
{
    Console.WriteLine("Deserializing an instance of the object.");
    FileStream fs = new FileStream(fileName,
    FileMode.Open);
    XmlDictionaryReader reader =
        XmlDictionaryReader.CreateTextReader(fs, new XmlDictionaryReaderQuotas());
    DataContractSerializer ser = new DataContractSerializer(typeof(Person));

    // Deserialize the data and read it from the instance.
    Person deserializedPerson =
        (Person)ser.ReadObject(reader, true);
    reader.Close();
    fs.Close();
    Console.WriteLine(String.Format("{0} {1}, ID: {2}",
    deserializedPerson.FirstName, deserializedPerson.LastName,
    deserializedPerson.ID));
}

Public Shared Sub ReadObject(ByVal fileName As String) 
    Console.WriteLine("Deserializing an instance of the object.")
    Dim fs As New FileStream(fileName, FileMode.Open)
    Dim reader As XmlDictionaryReader = _
        XmlDictionaryReader.CreateTextReader(fs, New XmlDictionaryReaderQuotas())
    Dim ser As New DataContractSerializer(GetType(Person))
    
    ' Deserialize the data and read it from the instance.
    Dim deserializedPerson As Person = CType(ser.ReadObject(reader, True), Person)
    reader.Close()
    fs.Close()
    Console.WriteLine(String.Format("{0} {1}, ID: {2}", deserializedPerson.FirstName, deserializedPerson.LastName, deserializedPerson.ID))
End Sub

Aplica-se a

ReadObject(XmlReader, Boolean)

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Lê o fluxo XML com um XmlReader e retorna o objeto desserializado e também especifica se uma verificação é feita para verificar o nome do objeto antes de ler seu valor.

public:
 override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader, bool verifyObjectName);

public override object ReadObject (System.Xml.XmlReader reader, bool verifyObjectName);

public override object? ReadObject (System.Xml.XmlReader reader, bool verifyObjectName);

override this.ReadObject : System.Xml.XmlReader * bool -> obj

Public Overrides Function ReadObject (reader As XmlReader, verifyObjectName As Boolean) As Object

Parâmetros

reader: XmlReader

O XmlReader usado para ler o fluxo XML.

verifyObjectName: Boolean

true para verificar se o nome do objeto corresponde ao valor de nome raiz fornecido no construtor, caso contrário, false.

Retornos

Object

O objeto desserializado.

Exceções

SerializationException

O parâmetro verifyObjectName é definido como true e o nome do elemento e o namespace não correspondem aos valores definidos no construtor.

Aplica-se a

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Origem:: DataContractSerializer.cs

Lê um documento ou fluxo de documentos XML e retorna o objeto desserializado. O método inclui um parâmetro para especificar se o nome do objeto é verificado e validado e um resolvedor para mapear declarações xsi:type em runtime.

public:
 System::Object ^ ReadObject(System::Xml::XmlDictionaryReader ^ reader, bool verifyObjectName, System::Runtime::Serialization::DataContractResolver ^ dataContractResolver);

public object? ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName, System.Runtime.Serialization.DataContractResolver? dataContractResolver);

public object ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName, System.Runtime.Serialization.DataContractResolver dataContractResolver);

override this.ReadObject : System.Xml.XmlDictionaryReader * bool * System.Runtime.Serialization.DataContractResolver -> obj

Public Function ReadObject (reader As XmlDictionaryReader, verifyObjectName As Boolean, dataContractResolver As DataContractResolver) As Object

Parâmetros

reader: XmlDictionaryReader

O leitor XML usado para ler o conteúdo.

verifyObjectName: Boolean

true para verificar o nome do objeto, caso contrário, false.

dataContractResolver: DataContractResolver

Uma implementação de DataContractResolver para mapear declarações xsi:type para tipos de contrato de dados.

Retornos

Object

O objeto desserializado.

Aplica-se a

Compartilhar via

DataContractSerializer.ReadObject Método

Definição

Sobrecargas

ReadObject(XmlReader)

Parâmetros

Retornos

Aplica-se a

ReadObject(XmlDictionaryReader, Boolean)

Parâmetros

Retornos

Exceções

Exemplos

Aplica-se a

ReadObject(XmlReader, Boolean)

Parâmetros

Retornos

Exceções

Aplica-se a

ReadObject(XmlDictionaryReader, Boolean, DataContractResolver)

Parâmetros

Retornos

Aplica-se a

Recursos adicionais