TrackingProfileSerializer.Deserialize(TextReader) 方法

定義

命名空間:

System.Workflow.Runtime.Tracking

組件:

System.Workflow.Runtime.dll

使用追蹤設定檔 XML 結構描述定義 (XSD) 還原序列化包含在文字閱讀器中的 XML 文件。

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

參數

reader

TextReader

包含 XML 文件的 TextReader。

傳回

TrackingProfile

包含還原序列化的追蹤設定檔的 TrackingProfile。

例外狀況

ArgumentNullException

reader 為 null 參考 (在 Visual Basic 中為 Nothing)。

TrackingProfileDeserializationException

reader 不包含符合追蹤設定檔 XSD 的文件。

備註

還原序列化指的是從格式正確的 XML 文件建立物件的程序。 Deserialize 會使用包含在 Schema 中的追蹤設定檔 XSD，將包含在文字讀取器中的 XML 文件還原序列化為有效的 TrackingProfile。 還原序列化期間會在 XML 文件上執行驗證，如果文件無效，則擲回 TrackingProfileDeserializationException。 您可以捕捉此例外狀況，並檢查 ValidationEventArgs 以判斷驗證錯誤的原因。 如果在還原序列化追蹤設定檔的期間有任何未處理的例外狀況，將終止要求追蹤設定檔的工作流程執行個體。

注意

如果您想要執行驗證，但不還原序列化追蹤設定檔的 XML 表示法，您可以寫入您自己的追蹤設定檔驗證程式。 如需詳細資訊，請參閱 Schema 屬性。