ChartSerializer.SerializableContent Vlastnost

Definice

Obor názvů:

System.Windows.Forms.DataVisualization.Charting

Sestavení:

System.Windows.Forms.DataVisualization.dll

Získá nebo nastaví vlastnosti grafu, které lze serializovat.

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

Hodnota vlastnosti

String

Výraz oddělený string čárkami, který představuje vlastnosti grafu, které mají být serializovány. Syntaxe je "Class.Property[,Class.Property]".

Poznámky

Ve výchozím nastavení budou všechny vlastnosti grafu serializovány při Save zavolání metod a Load . Vlastnost můžete použít NonSerializableContent k omezení vlastností grafu, které mají být serializovány, spolu s vlastnostmi SerializableContent a Content .

Vlastnost SerializableContent určuje, které charakteristiky grafu budou serializovány. Zástupné znaky lze použít v řetězcovém výrazu stejným způsobem jako NonSerializableContent vlastnost. Chcete-li například serializovat všechny vlastnosti grafu BackColor , nastavte tuto vlastnost na "*. BackColor".

Pokud ChartArea jsou zadány a/nebo Series podřízené vlastnosti, musí být zadány také názvy všech ChartArea objektů a Series objektů, aby se trvalá data mohla použít u existujících ChartArea objektů a Series objektů. To znamená, že musíte zadat výrazy "Series.Name" a "ChartArea.Name". Příklad tohoto postupu najdete v ukázkovém kódu níže. Podobně platí, že pokud se používá více oblastí grafu, ChartArea musí být uložena také vlastnost všech vykreslených grafů Series .

Někdy může být vlastnost nastavena tak, aby byla serializována a nikoli serializována, což je běžné při použití zástupných znaků. Výraz NonSerializableContent má v porovnání s výrazem nižší prioritu SerializableContent . Všimněte si však, že řetězcové výrazy, které používají zástupné znaky, mají menší váhu. Například pokud SerializableContent je vlastnost nastavená na "*. BackColor" a NonSerializableContent vlastnost je nastavena na BackColor, všechny vlastnosti BackColor s výjimkou ChartArea objektů budou serializovány.

Pokud nastavíte Content vlastnost, SerializableContent nastaví se interně. Content Pokud je vlastnost již nastavena, ale je třeba serializovat jinou vlastnost, nezapomeňte zřetězení SerializableContent vlastnosti při zadávání této další vlastnosti. Příklad tohoto postupu najdete v ukázkovém kódu níže.

Tato vlastnost ovlivňuje všechny operace ukládání, načítání a resetování.