ChartSerializer Kelas

Definisi

Ruang nama:

System.Web.UI.DataVisualization.Charting

Rakitan:

System.Web.DataVisualization.dll

Mengaktifkan serialisasi Chart kontrol.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Warisan

Object

ChartSerializer

Keterangan

Kelas ini diekspos sebagai Serializer properti kelas akar Chart .

Serialisasi menyimpan status bagan dan juga menyediakan opsi untuk memuat data berseri ke dalam bagan. Semua properti bagan dapat dipertahankan, termasuk data bagan. Selain itu, semua properti bagan yang ditandai untuk serialisasi dapat diatur ulang.

Kelas ini dapat digunakan secara opsional saat mengelola status tampilan yang ditentukan pengguna. Salah satu metodenya Load dapat digunakan untuk memuat status tampilan, dan salah Save satu metode dapat digunakan saat mengatur status tampilan.

FORMAT XML atau biner dapat digunakan untuk menyimpan data berseri. XML digunakan secara default, tetapi Anda dapat mengubah format dengan Format properti .

Properti bagan disimpan dan dimuat menggunakan Save metode dan Load . Perhatikan bahwa hanya properti dengan nilai non-default yang akan disimpan. Data dapat disimpan dan/atau dimuat menggunakan file, streaming, TextWriter, TextReader, XmlWriter dan XmlReader objek. Saat menyimpan dan/atau memuat data menggunakan objek yang berasal dari TextReaderkelas , , TextWriterXmlReader , atau XmlWriter , format data harus XML.

Daftar berikut menjelaskan tiga teknik, dari dasar hingga tingkat lanjut, digunakan untuk menentukan data yang dapat diserialisasikan. Perhatikan bahwa juga dimungkinkan untuk menentukan data yang tidak dapat diserialisasikan. Teknik ini dijelaskan dalam paragraf berikutnya.

• Serialisasi menggunakan Save metode dan Load , tanpa menentukan properti yang dapat diserialisasikanChart. Semua properti bagan dengan nilai non-default, yang mencakup data bagan, akan diserialisasikan.

• Membuat serialisasi properti bagan yang ditentukan oleh Content properti . Properti Content mengelompokkan properti bagan yang akan diserialisasikan ke dalam kategori seperti Data, Tampilan, dan sebagainya. Perhatikan bahwa nama objek dan Series secara otomatis diserialisasikanChartArea; data berseri kemudian diterapkan ke area dan seri bagan yang ada saat dimuat.

Penting

Properti Content diimplementasikan secara internal oleh Chart kontrol sebagai SerializableContent properti

• Serialisasi properti bagan yang ditentukan oleh SerializableContent properti . Ini adalah daftar yang dipisahkan koma dari semua properti bagan yang dapat diserialisasikan. Setelah properti ini diatur ke nilai eksplisit, pengembang bertanggung jawab untuk menentukan semua properti yang akan disimpan. Dengan kata lain, tidak seperti Content properti , nama area bagan dan seri tidak akan disimpan secara otomatis. Properti Content dan SerializableContent juga dapat digunakan bersamaan. Namun, pastikan bahwa SerializableContent digabungkan dengan dirinya sendiri saat diatur, jika tidak, properti bagan yang ditentukan oleh Content properti akan ditimpa.

Untuk melarang properti tertentu diserialisasikan, gunakan NonSerializableContent properti . Ketika satu properti diatur sebagai dapat diserialisasikan dan tidak dapat diserialisasikan, yang umum ketika kartubebas digunakan, SerializableContent properti telah diutamakan. Namun, prioritas juga tergantung pada berapa banyak kartubebas yang digunakan ketika properti ditentukan.

Secara default, properti yang dapat diserialisasikan diatur ulang ke defaultnya sebelum dimuat. Perilaku ini dapat diubah menggunakan IsResetWhenLoading properti . Metode ini Reset juga dapat digunakan untuk secara eksplisit mengatur ulang properti bagan ke nilai defaultnya.

Properti

Nama	Deskripsi
Content	Mendapatkan atau mengatur tipe konten bagan yang akan diserialisasikan.
Format	Mendapatkan atau mengatur format yang digunakan saat bagan diserialisasikan.
IsResetWhenLoading	Mendapatkan atau mengatur bendera yang menunjukkan apakah properti objek diatur ulang ke nilai default sebelum memuat.
IsTemplateMode	Mendapatkan atau mengatur bendera yang menunjukkan apakah serializer bagan berfungsi dalam mode pembuatan templat.
IsUnknownAttributeIgnored	Mendapatkan atau mengatur bendera yang menunjukkan apakah properti dan elemen XML yang tidak diketahui akan diabaikan tanpa melemparkan pengecualian.
NonSerializableContent	Mendapatkan atau mengatur properti bagan yang tidak akan diserialisasikan.
SerializableContent	Mendapatkan atau mengatur properti bagan yang dapat diserialisasikan.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetContentString(SerializationContents, Boolean)	Mengembalikan nama kelas dan/atau properti yang dapat diserialisasikan atau tidak dapat diserialisasikan, tergantung pada nilai bendera tertentu.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Load(Stream)	Memuat data berseri ke dalam kontrol dari objek yang berasal dari Stream kelas .
Load(String)	Memuat data berseri yang disimpan ke disk ke Chart dalam kontrol.
Load(TextReader)	Memuat data berseri ke dalam kontrol dari objek pembaca yang berasal dari TextReader kelas .
Load(XmlReader)	Memuat data berseri ke dalam kontrol dari objek yang berasal dari XmlReader kelas .
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Reset()	Mereset semua properti bagan yang ditandai untuk serialisasi.
Save(Stream)	Menyimpan data bagan dan properti dengan nilai non-default ke objek yang berasal dari Stream kelas.
Save(String)	Menyimpan data bagan dan properti dengan nilai non-default ke file yang diberikan.
Save(TextWriter)	Menyimpan data bagan dan properti dengan nilai non-default ke objek tertentu yang berasal dari TextWriter kelas .
Save(XmlWriter)	Menyimpan data bagan dan properti dengan nilai non-default ke objek tertentu yang berasal dari XmlWriter kelas .
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)