DataContractSerializer.ReadObject Método

Definição

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.

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

Parâmetros

reader
XmlReader

O XmlReader usado para ler o fluxo XML.

Retornos

O objeto desserializado.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 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
UWP 10.0

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.

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

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

O objeto desserializado.

Exceções

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 .

C#
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));
}

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 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
UWP 10.0

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.

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

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

O objeto desserializado.

Exceções

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

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 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
UWP 10.0

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.

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

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

O objeto desserializado.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 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