TrackingProfileSerializer.Deserialize(TextReader) Methode

Referenz

Definition

Namespace:: System.Workflow.Runtime.Tracking

Assembly:: System.Workflow.Runtime.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.

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

TrackingProfile mit dem deserialisierten Verfolgungsprofil.

Ausnahmen

ArgumentNullException

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

TrackingProfileDeserializationException

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:

Freigeben über