IDataContractSurrogate.GetObjectToSerialize(Object, Type) Methode

Referenz

Definition

Namespace:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt bei der Serialisierung ein Objekt zurück, das das angegebene Objekt ersetzt.

public:
 System::Object ^ GetObjectToSerialize(System::Object ^ obj, Type ^ targetType);

public object GetObjectToSerialize (object obj, Type targetType);

abstract member GetObjectToSerialize : obj * Type -> obj

Public Function GetObjectToSerialize (obj As Object, targetType As Type) As Object

Parameter

obj: Object

Das zu ersetzende Objekt.

targetType: Type

Der Type, dem das ersetzte Objekt zugewiesen werden soll.

Gibt zurück

Object

Das zu serialisierende ersetzte Objekt. Das Objekt muss über den DataContractSerializer serialisierbar sein. Er muss z. B. mit dem DataContractAttribute-Attribut oder anderen Mechanismen markiert sein, die das Serialisierungsprogramm erkennt.

Beispiele

Im folgenden Beispiel wird eine Implementierung der GetObjectToSerialize-Methode veranschaulicht.

public object GetObjectToSerialize(object obj, Type targetType)
{
        Console.WriteLine("GetObjectToSerialize Invoked");
        Console.WriteLine("\t type name: {0}", obj.ToString());
        Console.WriteLine("\t target type: {0}", targetType.Name);
        // This method is called on serialization.
        // If Person is not being serialized...
        if (obj is Person )
        {
            Console.WriteLine("\t returning PersonSurrogated");
            // ... use the XmlSerializer to perform the actual serialization.
            PersonSurrogated  ps = new PersonSurrogated();
            XmlSerializer xs = new XmlSerializer(typeof(Person));
            StringWriter sw = new StringWriter();
            xs.Serialize(sw, (Person)obj );
            ps.xmlData = sw.ToString();
            return ps;
        }
        return obj;
    }

Public Function GetObjectToSerialize(ByVal obj As Object, _
    ByVal targetType As Type) As Object _
    Implements IDataContractSurrogate.GetObjectToSerialize
    Console.WriteLine("GetObjectToSerialize Invoked")
    Console.WriteLine(vbTab & "type name: {0}", obj.ToString)
    Console.WriteLine(vbTab & "target type: {0}", targetType.Name)
    ' This method is called on serialization.
    ' If Person is not being serialized...
    If TypeOf obj Is Person Then
        Console.WriteLine(vbTab & "returning PersonSurrogated")
        ' ... use the XmlSerializer to perform the actual serialization.
        Dim ps As New PersonSurrogated()
        Dim xs As New XmlSerializer(GetType(Person))
        Dim sw As New StringWriter()
        xs.Serialize(sw, CType(obj, Person))
        ps.xmlData = sw.ToString()
        Return ps
    End If
    Return obj

End Function

Hinweise

Diese Methode darf nicht zurückgegeben null werden, da die Daten bei der Deerialisierung in den Typ Object gegossen werden und eine InvalidCastException ausgelöst wird.

Gilt für

Freigeben über