ChartSerializer Sınıf

Tanım

Ad Alanı:

System.Web.UI.DataVisualization.Charting

Bütünleştirilmiş Kod:

System.Web.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şaretlenen 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 Save biri görünüm durumu ayarlanırken 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üretilen bir nesne kullanarak verileri kaydederken ve/veya XmlWriter yüklerken, verilerin biçimi XML olmalıdır.

Aşağıdaki listede, serileştirilebilir verileri tanımlamak için kullanılan temelden gelişmişe kadar üç 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.

• Chart ve yöntemlerini kullanarak SaveLoad serileştirilebilir özellik belirtmeden seri hale 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 grafik Content ö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; serileştirilmiş veriler, yüklendiğinde mevcut grafik alanlarına ve serilerine uygulanır.

Önemli

Content özelliği, denetim 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ış 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ştirilmiş olduğundan emin olun SerializableContent , aksi takdirde özellik tarafından Content belirtilen grafik özellikleri geçersiz kılınacaktır.

Belirli özelliklerin seri hale getirilmesini yasaklamamak 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

Name	Description
Content	Seri hale getirilecek grafik içeriğinin türünü alır veya ayarlar.
Format	Grafik serileştirilirken 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ı gösteren bir bayrak alır veya ayarlar.
IsTemplateMode	Grafik serileştiricisinin şablon oluşturma modunda çalışıp çalışmadığını gösteren 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

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetContentString(SerializationContents, Boolean)	Belirli bir bayrak değerine bağlı olarak serileştirilebilir veya serileştirilebilir olmayan 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()	Geçerli örneğin Type 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 Objectbasit 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)	Varsayılan olmayan değerlerle grafik verilerini ve özelliklerini sınıfından türetilen bir nesneye Stream kaydeder.
Save(String)	Grafik verilerini ve özelliklerini varsayılan olmayan değerlerle belirtilen dosyaya kaydeder.
Save(TextWriter)	Varsayılan olmayan değerlerle grafik verilerini ve özelliklerini sınıfından türetilen belirli bir nesneye TextWriter kaydeder.
Save(XmlWriter)	Varsayılan olmayan değerlerle grafik verilerini ve özelliklerini sınıfından türetilen belirli bir nesneye XmlWriter kaydeder.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)