Udostępnij za pośrednictwem


ChartSerializer Klasa

Definicja

Umożliwia serializacji kontrolki Chart .

public ref class ChartSerializer
public class ChartSerializer
type ChartSerializer = class
Public Class ChartSerializer
Dziedziczenie
ChartSerializer

Uwagi

Ta klasa jest uwidoczniona jako Serializer właściwość klasy głównej Chart .

Serializacja zapisuje stan wykresu, a także umożliwia załadowanie serializowanych danych do wykresu. Wszystkie właściwości wykresu można utrwalać, w tym dane wykresu. Ponadto wszystkie właściwości wykresu oznaczone do serializacji można zresetować.

Ta klasa może być opcjonalnie używana podczas zarządzania stanem widoku zdefiniowanego przez użytkownika. Jedną z jego Load metod można użyć do załadowania stanu widoku, a jedną z Save metod można użyć podczas ustawiania stanu widoku.

Formaty XML lub binarne mogą służyć do przechowywania danych serializowanych. Kod XML jest domyślnie używany, ale można zmienić format za pomocą Format właściwości .

Właściwości wykresu są zapisywane i ładowane odpowiednio przy użyciu Save metod i Load . Należy pamiętać, że zostaną zapisane tylko właściwości z wartościami innych niż domyślne. Dane można zapisywać i/lub ładować przy użyciu pliku, strumienia, TextWriter, TextReaderXmlWriter i XmlReader obiektów. Podczas zapisywania i/lub ładowania danych przy użyciu obiektu pochodzącego z TextReaderklas , XmlReaderTextWriterlub XmlWriter format danych musi być xml.

Poniższa lista zawiera opis trzech technik, od podstawowych do zaawansowanych, używanych do definiowania danych z możliwością serializacji. Należy pamiętać, że można również zdefiniować dane nieserejelizowalne. Ta technika jest opisana w następnym akapicie.

  • Serializowanie Chart przy użyciu Save metod i Load bez określania żadnych właściwości możliwych do serializacji. Wszystkie właściwości wykresu z wartościami innymi niż domyślne, w tym dane wykresu, zostaną serializowane.

  • Serializuj właściwości wykresu Content określone przez właściwość. Właściwość Content grupuje właściwości wykresu do serializacji w kategorie, takie jak Dane, Wygląd i tak dalej. Należy pamiętać, że nazwy ChartArea obiektów i Series są automatycznie serializowane; dane serializowane są następnie stosowane do istniejących obszarów wykresu i serii po załadowaniu.

Ważne

Właściwość Content jest implementowana wewnętrznie przez kontrolkę ChartSerializableContent jako właściwość

  • Serializacja właściwości wykresu SerializableContent określonych przez właściwość. Jest to rozdzielona przecinkami lista wszystkich właściwości wykresu, które można serializować. Po ustawieniu tej właściwości na jawną wartość jest to odpowiedzialność dewelopera za określenie wszystkich właściwości do zapisania. Innymi słowy, w przeciwieństwie do Content właściwości, nazwy obszarów wykresu i serii nie będą automatycznie utrwalane. Właściwości Content i SerializableContent można również używać w połączeniu. Upewnij się jednak, że SerializableContent jest ona połączona z samym sobą podczas ustawiania, w przeciwnym razie właściwości wykresu określone przez Content właściwość zostaną zastąpione.

Aby uniemożliwić serializacji niektórych właściwości, użyj NonSerializableContent właściwości . Gdy jedna właściwość jest ustawiana jako serializowalne i nies serializowalne, co jest wspólne, gdy są używane symbole wieloznaczne, SerializableContent właściwość ma pierwszeństwo. Pierwszeństwo zależy jednak również od liczby symboli wieloznacznych używanych podczas określania właściwości.

Domyślnie właściwości z możliwością serializacji są resetowane do ich wartości domyślnych przed ich załadowaniem. To zachowanie można zmienić przy użyciu IsResetWhenLoading właściwości . Metoda Reset może również służyć do jawnego resetowania właściwości wykresu do ich wartości domyślnych.

Właściwości

Content

Pobiera lub ustawia typ zawartości wykresu do serializacji.

Format

Pobiera lub ustawia format używany podczas serializacji wykresu.

IsResetWhenLoading

Pobiera lub ustawia flagę wskazującą, czy właściwości obiektu są resetowane do wartości domyślnych przed załadowaniem.

IsTemplateMode

Pobiera lub ustawia flagę wskazującą, czy serializator wykresu działa w trybie tworzenia szablonu.

IsUnknownAttributeIgnored

Pobiera lub ustawia flagę wskazującą, czy nieznane właściwości i elementy XML zostaną zignorowane bez zgłaszania wyjątku.

NonSerializableContent

Pobiera lub ustawia właściwości wykresu, które nie zostaną serializowane.

SerializableContent

Pobiera lub ustawia właściwości wykresu, które można serializować.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetContentString(SerializationContents, Boolean)

Zwraca nazwy klasy i/lub właściwości, które można serializować, w zależności od określonej wartości flagi.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
Load(Stream)

Ładuje dane serializowane do kontrolki z obiektu pochodzącego Stream z klasy.

Load(String)

Ładuje serializowane dane zapisane na dysku w kontrolce Chart .

Load(TextReader)

Ładuje dane serializowane do kontrolki z obiektu czytnika, który pochodzi z TextReader klasy.

Load(XmlReader)

Ładuje dane serializowane do kontrolki z obiektu pochodzącego XmlReader z klasy.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Reset()

Resetuje wszystkie właściwości wykresu oznaczone do serializacji.

Save(Stream)

Zapisuje dane i właściwości wykresu przy użyciu wartości innych niż domyślne do obiektu pochodzącego Stream z klasy.

Save(String)

Zapisuje dane i właściwości wykresu z wartościami innych niż domyślne w danym pliku.

Save(TextWriter)

Zapisuje dane wykresu i właściwości z wartościami innych niż domyślne dla danego obiektu, który pochodzi z TextWriter klasy.

Save(XmlWriter)

Zapisuje dane wykresu i właściwości z wartościami innych niż domyślne dla danego obiektu, który pochodzi z XmlWriter klasy.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy