Udostępnij za pośrednictwem


ChartSerializer Klasa

Definicja

Włącza serializacji kontrolki Chart .

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

Uwagi

Ta klasa jest uwidaczniona 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 można zresetować wszystkie właściwości wykresu oznaczone do serializacji.

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 używany domyślnie, ale można zmienić format za Format pomocą właściwości .

Właściwości wykresu są zapisywane i ładowane 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 TextReaderz klas , XmlReaderTextWriterlub XmlWriter format danych musi być xml.

Poniższa lista zawiera opis trzech technik , od podstawowych do zaawansowanych, używanych do definiowania danych możliwych do serializacji. Należy pamiętać, że istnieje również możliwość zdefiniowania danych, które nie można serializować. Ta technika jest opisana w następnym akapicie.

  • Serializuj Chart metodę Save i Load bez określania 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 obiektów i Series są automatycznie serializowane; serializowane dane są następnie stosowane do istniejących obszarów wykresu ChartArea 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 określonych przez SerializableContent 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ść deweloper jest odpowiedzialny 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 Content określone przez 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 z możliwością serializacji i niesererowalna, co jest wspólne w przypadku użycia symboli wieloznacznych, SerializableContent właściwość ma pierwszeństwo. Jednak pierwszeństwo zależy również od liczby symboli wieloznacznych użytych podczas określania właściwości.

Domyślnie właściwości możliwe do serializacji są resetowane do ustawień 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 nazwę klasy możliwej do serializacji lub nieserejserowalnej i/lub właściwości, 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 wartość bieżącego wystąpienia.

(Odziedziczone po Object)
Load(Stream)

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

Load(String)

Ładuje serializowane dane zapisane na dysku w kontrolce Chart .

Load(TextReader)

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

Load(XmlReader)

Ładuje serializowane dane 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 wykresu i właściwości z wartościami innych niż domyślne w obiekcie pochodzącym Stream z klasy.

Save(String)

Zapisuje dane wykresu i właściwości 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 pochodzącego TextWriter z klasy.

Save(XmlWriter)

Zapisuje dane wykresu i właściwości z wartościami innych niż domyślne dla danego obiektu pochodzącego XmlWriter z klasy.

ToString()

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

(Odziedziczone po Object)

Dotyczy