ChartSerializer Sınıf

Tanım

Ad Alanı:

System.Windows.Forms.DataVisualization.Charting

Bütünleştirilmiş Kod:

System.Windows.Forms.DataVisualization.dll

Denetimin seri hale getirilmesini Chart etkinleştirir.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Devralma

Object

ChartSerializer

Açıklamalar

Bu sınıf, kök Chart sınıfın Serializer özelliği olarak kullanıma sunulur.

Serileştirme grafiğin durumunu kaydeder ve ayrıca serileştirilmiş verileri grafiğe yükleme seçeneği sağlar. Grafiğin verileri de dahil olmak üzere tüm grafik özellikleri kalıcı hale gelebilir. Ayrıca, serileştirme için işaretlenmiş tüm grafik özellikleri sıfırlanabilir.

Bu sınıf, kullanıcı tanımlı görünüm durumu yönetildiğinde isteğe bağlı olarak kullanılabilir. Yöntemlerinden Load biri görünüm durumunu yüklemek için kullanılabilir ve yöntemlerden biri Save de görünüm durumunu ayarlarken kullanılabilir.

XML veya ikili biçimler, serileştirilmiş verileri depolamak için kullanılabilir. XML varsayılan olarak kullanılır, ancak biçimi özelliğiyle Format değiştirebilirsiniz.

Grafik özellikleri sırasıyla ve yöntemleri kullanılarak Save kaydedilir ve Load yüklenir. Yalnızca varsayılan olmayan değerlere sahip özelliklerin kaydedileceğini unutmayın. Veriler dosya, akışTextWriter, , TextReaderXmlWriter ve nesneleri kullanılarak kaydedilebilir veXmlReader/veya yüklenebilir. , TextWriterXmlReader veya sınıflarından TextReadertüretilmiş bir nesne kullanarak veri kaydederken ve/veya XmlWriter yüklerken, verilerin biçimi XML olmalıdır.

Aşağıdaki listede, temelden gelişmişe kadar seri hale getirilebilir verileri tanımlamak için kullanılan üç teknik açıklanmaktadır. Seri hale getirilemez veriler tanımlamanın da mümkün olduğunu unutmayın. Bu teknik sonraki paragrafta açıklanmıştır.

• seri hale getirilebilir özellik belirtmeden ve Load yöntemlerini kullanarak Save seri hale Chart getirme. Grafik verilerini içeren varsayılan olmayan değerlere sahip tüm grafik özellikleri seri hale getirilir.

• özelliği tarafından belirtilen grafik özelliklerini seri hale getirme Content . Content özelliği, grafik özelliklerini veri, görünüm vb. kategoriler halinde seri hale getirilecek şekilde gruplandırmaktadır. ve Series nesnelerinin adlarının ChartArea otomatik olarak seri hale getirildiğini unutmayın; seri hale getirilmiş veriler, yüklendiğinde var olan grafik alanlarına ve serilerine uygulanır.

Önemli

Content özelliği, denetimi tarafından Chart özellik olarak dahili olarak SerializableContent uygulanır

• özelliği tarafından belirtilen grafik özelliklerinin seri hale getirilmesi SerializableContent . Bu, serileştirilebilir tüm grafik özelliklerinin virgülle ayrılmış bir listesidir. Bu özellik açık bir değere ayarlandıktan sonra, kaydedilecek tüm özellikleri belirtmek geliştiricinin sorumluluğundadır. Başka bir deyişle, özelliğinden Content farklı olarak, grafik alanlarının ve serilerinin adları otomatik olarak kalıcı olmaz. Content ve SerializableContent özellikleri birlikte de kullanılabilir. Ancak, ayarlanırken kendisiyle birleştirildiğinden emin olun SerializableContent , aksi takdirde özelliği tarafından Content belirtilen grafik özellikleri geçersiz kılınacaktır.

Belirli özelliklerin seri hale getirilmeye engel olması için özelliğini kullanın NonSerializableContent . Bir özellik seri hale getirilebilir ve seri hale getirilemez olarak ayarlandığında ( joker karakterler kullanıldığında yaygın olarak görülür) özelliğin SerializableContent önceliği vardır. Ancak öncelik, bir özellik belirtildiğinde kaç joker karakter kullanıldığına da bağlıdır.

Varsayılan olarak, seri hale getirilebilir özellikler yüklenmeden önce varsayılanlarına sıfırlanır. Bu davranış özelliği kullanılarak IsResetWhenLoading değiştirilebilir. yöntemi, Reset grafik özelliklerini varsayılan değerlerine açıkça sıfırlamak için de kullanılabilir.

Özellikler

Content	Seri hale getirilecek grafik içeriğinin türünü alır veya ayarlar.
Format	Grafik seri hale getirildiğinde kullanılan biçimi alır veya ayarlar.
IsResetWhenLoading	Nesne özelliklerinin yüklenmeden önce varsayılan değerlere sıfırlanıp sıfırlanmayacağını belirten bir bayrak alır veya ayarlar.
IsTemplateMode	Grafik serileştiricisinin şablon oluşturma modunda çalışıp çalışmadığını belirten bir bayrak alır veya ayarlar.
IsUnknownAttributeIgnored	Bilinmeyen XML özelliklerinin ve öğelerinin özel durum oluşturmadan yoksayılıp yoksayılmayacağını belirten bir bayrak alır veya ayarlar.
NonSerializableContent	Serileştirilmeyecek grafik özelliklerini alır veya ayarlar.
SerializableContent	Seri hale getirilebilen grafik özelliklerini alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetContentString(SerializationContents, Boolean)	Belirli bayrak değerine bağlı olarak, seri hale getirilebilir veya seri hale getirilemez bir sınıf ve/veya özellik adları döndürür.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Load(Stream)	Sınıfından türetilen Stream bir nesneden denetime serileştirilmiş verileri yükler.
Load(String)	Diske kaydedilen serileştirilmiş verileri denetime Chart yükler.
Load(TextReader)	Sınıfından türetilen TextReader bir okuyucu nesnesinden denetime serileştirilmiş verileri yükler.
Load(XmlReader)	Sınıfından türetilen XmlReader bir nesneden denetime serileştirilmiş verileri yükler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Reset()	Serileştirme için işaretlenmiş tüm grafik özelliklerini sıfırlar.
Save(Stream)	Grafik verilerini ve özelliklerini varsayılan olmayan değerlerle sınıftan türetilen bir nesneye Stream kaydeder.
Save(String)	Grafik verilerini ve özelliklerini varsayılan olmayan değerlerle belirtilen dosyaya kaydeder.
Save(TextWriter)	Grafik verilerini ve özelliklerini varsayılan olmayan değerlerle sınıftan türetilen verilen nesneye TextWriter kaydeder.
Save(XmlWriter)	Grafik verilerini ve özelliklerini varsayılan olmayan değerlerle sınıftan türetilen verilen nesneye XmlWriter kaydeder.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)