ChartSerializer Sınıf

Tanım

Denetimin seri hale getirilmesini Chart etkinleştirir.

public ref class ChartSerializer
public class ChartSerializer
type ChartSerializer = class
Public Class ChartSerializer
Devralma
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. Load Görünüm durumunu yüklemek için yöntemlerinden biri kullanılabilir ve görünüm durumu ayarlanırken yöntemlerden biri Save 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 Load yöntemleri kullanılarak Save kaydedilir ve 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 verileri kaydederken ve/veya XmlWriter yüklerken, verilerin biçimi XML olmalıdır.

Aşağıdaki listede, seri hale getirilebilir verileri tanımlamak için kullanılan temelden gelişmişe kadar üç teknik açıklanmaktadır. Seri hale getirilemez verileri tanımlamanın da mümkün olduğunu unutmayın. Bu teknik bir 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 . özelliği, Content grafik özelliklerini seri hale getirilecek Şekilde Veri, Görünüm vb. kategoriler halinde gruplandırmaktadır. ve Series nesnelerinin adlarının ChartArea otomatik olarak seri hale getirildiğini unutmayın; serileştirilmiş veriler, yüklendiğinde mevcut 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, seri hale getirilebilen 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 bunun SerializableContent kendisiyle birleştirilmiş olduğundan emin olun, aksi takdirde özelliği tarafından Content belirtilen grafik özellikleri geçersiz kılınır.

Belirli özelliklerin seri hale getirilmesini yasakmak için özelliğini kullanın NonSerializableContent . Bir özellik serileştirilebilir 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, serileştirilebilir özellikler yüklenmeden önce varsayılan değerlerine 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üklemeden önce varsayılan değerlere sıfırlanıp sıfırlanmayacağını gösteren 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

Serileştirilebilen 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 serileştirilebilir veya serileştirilebilir olmayan 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 verilen 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)

Şunlara uygulanır