ChartSerializer.SerializableContent Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms.DataVisualization.Charting

Zestaw:

System.Windows.Forms.DataVisualization.dll

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

public:
 property System::String ^ SerializableContent { System::String ^ get(); void set(System::String ^ value); };

public string SerializableContent { get; set; }

member this.SerializableContent : string with get, set

Public Property SerializableContent As String

Wartość właściwości

String

Wyrażenie rozdzielane string przecinkami, które reprezentuje właściwości wykresu do serializacji. Składnia to "Class.Property[,Class.Property]".

Uwagi

Domyślnie wszystkie właściwości wykresu będą serializowane po wywołaniu Save metod i Load . Za pomocą NonSerializableContent właściwości można ograniczyć charakterystykę wykresu do serializacji wraz z właściwościami SerializableContent i Content .

Właściwość SerializableContent określa, które cechy wykresu będą serializowane. Symbole wieloznaczne mogą być używane w wyrażeniu ciągu w taki sam sposób jak NonSerializableContent właściwość . Aby na przykład serializować wszystkie właściwości wykresu BackColor , ustaw tę właściwość na "*. BackColor".

Jeśli ChartArea określono właściwości i/lub Series podrzędne, należy również określić nazwy wszystkich ChartArea obiektów i Series , aby umożliwić stosowanie utrwalone dane do istniejących ChartArea obiektów i Series , czyli należy określić wyrażenia "Series.Name" i "ChartArea.Name". Zobacz przykładowy kod poniżej, aby zapoznać się z przykładem tej procedury. Podobnie, jeśli jest używanych wiele obszarów wykresu, ChartArea należy również zapisać właściwość wszystkich wykreślionych Series .

Czasami można ustawić właściwość tak, aby była serializowana, a nie serializowana, co jest powszechne w przypadku użycia symboli wieloznacznych. Wyrażenie NonSerializableContent ma niższy priorytet w porównaniu z wyrażeniem SerializableContent . Należy jednak zauważyć, że mniejsza waga jest przypisywana do wyrażeń ciągów korzystających z symboli wieloznacznych. Jeśli na przykład właściwość jest ustawiona SerializableContent na "*. Właściwość BackColor" i NonSerializableContent właściwość jest ustawiona na BackColor, wszystkie właściwości BackColor z wyjątkiem ChartArea obiektów zostaną serializowane.

Jeśli ustawisz Content właściwość , SerializableContent właściwość zostanie ustawiona wewnętrznie. Content Jeśli właściwość jest już ustawiona, ale należy serializować inną właściwość, pamiętaj o połączeniu SerializableContent właściwości podczas określania tej dodatkowej właściwości. Zobacz przykładowy kod poniżej, aby zapoznać się z przykładem tej procedury.

Ta właściwość ma wpływ na wszystkie operacje zapisywania, ładowania i resetowania.