ChartSerializer.Load 方法

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

將序列化的資料載入控制器 Chart 。

多載

名稱	Description
Load(XmlReader)	將序列化資料載入控制項，從類別衍生的 XmlReader 物件。
Load(String)	將儲存到磁碟的序列化資料載入 Chart 控制器。
Load(Stream)	將序列化資料載入控制項，從類別衍生的 Stream 物件。
Load(TextReader)	從類別衍生 TextReader 的讀取物件載入序列化資料到控制項中。

Load(XmlReader)

將序列化資料載入控制項，從類別衍生的 XmlReader 物件。

public:
 void Load(System::Xml::XmlReader ^ reader);

public void Load(System.Xml.XmlReader reader);

member this.Load : System.Xml.XmlReader -> unit

Public Sub Load (reader As XmlReader)

參數

reader

XmlReader

一個用來讀取持久化資料的物件。 這個物件是從 XmlReader 類別衍生出來的，可以是 .NET Framework 物件或使用者自訂物件。

備註

呼叫此方法將序列化資料載入控制項。Chart

當載入操作發生時，預設情況下，可序列化的屬性會先被重置回預設值，然後才會被設定為持久化的值（若已儲存）。 要改變這種行為，請使用屬性。IsResetWhenLoading

預設情況下，所有序列化圖表屬性都會被載入。 如果你設定了 Content， SerializableContent 或 NonSerializableContent 屬性，可以載入特定的屬性集合。

使用此定義時，格式必須為 XML;格式可以依據 Format 該性質進行調整。

當你處理 XML 格式的文字檔時，為了簡單起見，建議改用這個 Load 方法。

Load(String)

將儲存到磁碟的序列化資料載入 Chart 控制器。

public:
 void Load(System::String ^ fileName);

public void Load(string fileName);

member this.Load : string -> unit

Public Sub Load (fileName As String)

參數

fileName

String

用於儲存序列化資料的檔案相對或絕對路徑。 若指定相對路徑，則該路徑將相對於目前目錄。

備註

呼叫此方法將序列化資料載入控制項。Chart

當載入操作發生時，預設情況下，可序列化的屬性會先被重置為預設值，然後才會被設定為持久化的值（若已儲存）。 要改變這種行為，請使用屬性。IsResetWhenLoading

預設情況下，所有序列化圖表屬性都會被載入。 要載入特定的序列化屬性，請先設定 Content ，NonSerializableContentSerializableContent或 屬性再載入資料。

請注意，當資料以某種 Save 方法儲存時，只有那些具有非預設值的屬性才會被序列化。

Load(Stream)

將序列化資料載入控制項，從類別衍生的 Stream 物件。

public:
 void Load(System::IO::Stream ^ stream);

public void Load(System.IO.Stream stream);

member this.Load : System.IO.Stream -> unit

Public Sub Load (stream As Stream)

參數

stream

Stream

例如，從 Stream 類別衍生出的物件，例如物件 MemoryStream 。

備註

呼叫此方法將序列化資料載入控制項。Chart

當載入操作發生時，預設情況下，可序列化的屬性會先被重置為預設值，然後才會被設定為持久化的值（若已儲存）。 要改變這種行為，請使用屬性。IsResetWhenLoading

預設情況下，所有序列化圖表屬性都會被載入。 要載入特定的序列化屬性，請先設定 Content ，NonSerializableContentSerializableContent或 屬性再載入資料。

請注意，當資料以某種 Save 方法儲存時，只有那些具有非預設值的屬性才會被序列化。

Load(TextReader)

從類別衍生 TextReader 的讀取物件載入序列化資料到控制項中。

public:
 void Load(System::IO::TextReader ^ reader);

public void Load(System.IO.TextReader reader);

member this.Load : System.IO.TextReader -> unit

Public Sub Load (reader As TextReader)

參數

reader

TextReader

一個讀取器，例如 StringReader，且它是從抽象 TextReader 類別推導而來的。

備註

呼叫此方法將序列化資料載入控制項。Chart

當載入操作發生時，預設情況下，可序列化的屬性會先被重置為預設值，然後才會被設定為持久化的值（若已儲存）。 要改變這種行為，請使用屬性。IsResetWhenLoading

預設情況下，所有序列化圖表屬性都會被載入。 透過設定 Content， SerializableContent 或 NonSerializableContent 屬性，可以載入一組特定的屬性。

如果你使用這個定義，請注意格式必須是 XML，而這個格式是由 Format 屬性設定的。