DataContractSerializer.IsStartObject Método

Definición

Espacio de nombres:

System.Runtime.Serialization

Ensamblado:

System.Runtime.Serialization.Xml.dll

Determina si el lector se coloca en un objeto que se puede deserializar.

Sobrecargas

IsStartObject(XmlReader)	Determina si XmlReader se coloca en un objeto que se puede deserializar.
IsStartObject(XmlDictionaryReader)	Determina si XmlDictionaryReader se coloca en un objeto que se puede deserializar.

IsStartObject(XmlReader)

Source:

DataContractSerializer.cs

Determina si XmlReader se coloca en un objeto que se puede deserializar.

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

XmlReader utilizado para leer la secuencia XML.

Devoluciones

Boolean

Es true si el lector está situado en el elemento de inicio de la secuencia que se leerá; en caso contrario, false.

IsStartObject(XmlDictionaryReader)

Source:

DataContractSerializer.cs

Determina si XmlDictionaryReader se coloca en un objeto que se puede deserializar.

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

XmlDictionaryReader que se usa para leer la secuencia XML.

Devoluciones

Boolean

Es true si el lector está situado en el elemento de inicio de la secuencia que se leerá; en caso contrario, false.

Ejemplos

El ejemplo siguiente utiliza la propiedad IsStartObject para determinar si se ha encontrado el inicio de los datos.

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

Comentarios

IsStartObject determina si puede leer un objeto comprobando que se coloca en un elemento XML. También examina el nombre y el espacio de nombres del elemento XML donde el lector se coloca y compara los valores con el nombre y el espacio de nombres esperados. El nombre y el espacio de nombres esperados se pueden establecer con lo siguiente: el nombre y el espacio de nombres de contrato de datos del tipo pasado al constructor o los valores rootName y rootNamespace pasados al constructor (si está presente).