TrackingProfileSerializer.Deserialize(TextReader) Methode

Definition

Deserialisiert das im Textreader enthaltene XML-Dokument anhand der XML-Schemadefinition (XSD) für Verfolgungsprofile.

public:
 System::Workflow::Runtime::Tracking::TrackingProfile ^ Deserialize(System::IO::TextReader ^ reader);
public System.Workflow.Runtime.Tracking.TrackingProfile Deserialize (System.IO.TextReader reader);
member this.Deserialize : System.IO.TextReader -> System.Workflow.Runtime.Tracking.TrackingProfile
Public Function Deserialize (reader As TextReader) As TrackingProfile

Parameter

reader
TextReader

TextReader mit einem XML-Dokument.

Gibt zurück

TrackingProfile mit dem deserialisierten Verfolgungsprofil.

Ausnahmen

reader ist ein NULL-Verweis (Nothing in Visual Basic).

reader enthält kein Dokument, das der Verfolgungsprofil-XSD entspricht.

Hinweise

Das Erstellen eines Objekts aus einem wohlgeformten XML-Dokument wird als Deserialisierung bezeichnet. Deserialize verwendet die in Schema enthaltene Verfolgungsprofil-XSD, um das im Textreader enthaltene XML-Dokument in ein gültiges TrackingProfile zu deserialisieren. Die Validierung des XML-Dokuments erfolgt während der Deserialisierung. Wenn das Dokument nicht gültig ist, wird TrackingProfileDeserializationException ausgelöst. Sie können diese Ausnahme abfangen und ValidationEventArgs überprüfen, um die Ursache des Validierungsfehlers zu ermitteln. Falls während der Deserialisierung des Verfolgungsprofils nicht behandelte Ausnahmen auftreten, wird die Workflowinstanz beendet, für die das Verfolgungsprofil angefordert wurde.

Hinweis

Wenn Sie eine Validierung ohne Deserialisierung der XML-Darstellung eines Verfolgungsprofils ausführen möchten, können Sie ein eigenes Validierungssteuerelement zum Verfolgen von Profilen schreiben. Weitere Informationen finden Sie in den Ausführungen zur Schema-Eigenschaft.

Gilt für: