DataContractSerializer.IsStartObject Método

Definição

Namespace:

System.Runtime.Serialization

Assembly:

System.Runtime.Serialization.Xml.dll

Assembly:

System.Runtime.Serialization.dll

Assembly:

netstandard.dll

Determina se o leitor está posicionado em um objeto que pode ser desserializado.

Sobrecargas

IsStartObject(XmlReader)	Determina se o XmlReader está posicionado em um objeto que pode ser desserializado.
IsStartObject(XmlDictionaryReader)	Determina se o XmlDictionaryReader está posicionado em um objeto que pode ser desserializado.

IsStartObject(XmlReader)

Determina se o XmlReader está posicionado em um objeto que pode ser desserializado.

public:
 override bool IsStartObject(System::Xml::XmlReader ^ reader);

public override bool IsStartObject (System.Xml.XmlReader reader);

override this.IsStartObject : System.Xml.XmlReader -> bool

Public Overrides Function IsStartObject (reader As XmlReader) As Boolean

Parâmetros

reader

XmlReader

O XmlReader usado para ler o fluxo XML.

Retornos

Boolean

true se o leitor estiver no elemento de início do fluxo a ser lido, caso contrário, false.

IsStartObject(XmlDictionaryReader)

Determina se o XmlDictionaryReader está posicionado em um objeto que pode ser desserializado.

public:
 override bool IsStartObject(System::Xml::XmlDictionaryReader ^ reader);

public override bool IsStartObject (System.Xml.XmlDictionaryReader reader);

override this.IsStartObject : System.Xml.XmlDictionaryReader -> bool

Public Overrides Function IsStartObject (reader As XmlDictionaryReader) As Boolean

Parâmetros

reader

XmlDictionaryReader

Um XmlDictionaryReader usado para ler o fluxo XML.

Retornos

Boolean

true se o leitor estiver no elemento de início do fluxo a ser lido, caso contrário, false.

Exemplos

O exemplo a seguir usa a IsStartObject propriedade para determinar se o início dos dados foi encontrado.

public static void ReadObjectData(string path)
{
    // Create the reader.
    FileStream fs = new FileStream(path, FileMode.Open);
    XmlDictionaryReader reader =
        XmlDictionaryReader.CreateTextReader(fs, new XmlDictionaryReaderQuotas());

    // Create the DataContractSerializer specifying the type,
    // root and namespace to use. The root value corresponds
    // to the DataContract.Name value, and the namespace value
    // corresponds to the DataContract.Namespace value.
    DataContractSerializer ser =
        new DataContractSerializer(typeof(Person),
        "Customer", @"http://www.contoso.com");

    // Test if the serializer is on the start of the
    // object data. If so, read the data and write it
    // to the console.
    while (reader.Read())
    {
        if (ser.IsStartObject(reader))
        {
            Console.WriteLine("Found the element");
            Person p = (Person)ser.ReadObject(reader);
            Console.WriteLine("{0} {1}    id:{2}",
                p.FirstName, p.LastName, p.ID);
        }

        Console.WriteLine(reader.Name);
        break;
    }
    fs.Flush();
    fs.Close();
}

Public Shared Sub ReadObjectData(ByVal path As String) 
    ' Create the reader.
    Dim fs As New FileStream(path, FileMode.Open)
    Dim reader As XmlDictionaryReader = _
        XmlDictionaryReader.CreateTextReader(fs, New XmlDictionaryReaderQuotas())
    
    ' Create the DataContractSerializer specifying the type, 
    ' root and namespace to use. The root value corresponds
    ' to the DataContract.Name value, and the namespace value
    ' corresponds to the DataContract.Namespace value.
    Dim ser As New DataContractSerializer(GetType(Person), _
        "Customer", "http://www.contoso.com")
    
    ' Test if the serializer is on the start of the 
    ' object data. If so, read the data and write it 
    ' to the console.
    While reader.Read()
        If ser.IsStartObject(reader) Then
            Console.WriteLine("Found the element")
            Dim p As Person = CType(ser.ReadObject(reader), Person)
            Console.WriteLine("{0} {1}    id:{2}", p.FirstName, p.LastName, p.ID)
        End If
                
        Console.WriteLine(reader.Name)
    End While
    
    fs.Flush()
    fs.Close()

End Sub

Comentários

O IsStartObject determina se ele pode ler um objeto verificando se ele está posicionado em um elemento XML. Ele também examina o nome e o namespace do elemento XML no qual o leitor está posicionado e compara os valores com o nome e o namespace esperados. O nome e o namespace esperados podem ser definidos com o seguinte: o nome do contrato de dados e o namespace do tipo passado para o construtor ou os rootName valores passados rootNamespace para o construtor (se presente).