ChartSerializer.SerializableContent Eigenschaft

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Ruft die Diagrammeigenschaften ab, die serialisiert werden können, oder legt diese fest.

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

Eigenschaftswert

String

Ein durch Trennzeichen getrennter string-Ausdruck, der die zu serialisierenden Diagrammeigenschaften darstellt. Die Syntax lautet "Klasse.Eigenschaft[,Klasse.Eigenschaft]".

Hinweise

Standardmäßig werden alle Diagrammeigenschaften serialisiert, wenn die Save Methoden und Load aufgerufen werden. Sie können die -Eigenschaft verwenden, um die zu serialisierenden Diagrammmerkmale zusammen mit den Eigenschaften NonSerializableContent SerializableContent und zu Content begrenzen.

Die SerializableContent -Eigenschaft bestimmt, welche Diagrammmerkmale serialisiert werden. Platzhalter können im Zeichenfolgenausdruck auf die gleiche Weise wie die -Eigenschaft verwendet NonSerializableContent werden. Um beispielsweise alle Diagrammeigenschaften zu BackColor serialisieren, legen Sie diese Eigenschaft auf "*" fest. BackColor".

Wenn und/oder untergeordnete Eigenschaften angegeben werden, müssen auch die Namen aller - und -Objekte angegeben werden, damit die persistenten Daten auf vorhandene - und -Objekte angewendet werden können. Das heißt, Sie müssen die Ausdrücke ChartArea Series "Series.Name" und ChartArea Series ChartArea Series "ChartArea.Name" angeben. Im folgenden Beispielcode finden Sie ein Beispiel für dieses Verfahren. Wenn mehrere Diagrammbereiche verwendet werden, muss auch die -Eigenschaft aller geplotten ChartArea Series -Diagramme gespeichert werden.

Manchmal kann eine Eigenschaft so festgelegt werden, dass sie sowohl serialisiert als auch nicht serialisiert wird. Dies kommt häufig vor, wenn Platzhalter verwendet werden. Der NonSerializableContent Ausdruck hat im Vergleich zum Ausdruck eine niedrigere SerializableContent Priorität. Beachten Sie jedoch, dass Zeichenfolgenausdrücken, die Platzhalter verwenden, weniger Gewichtung erhalten. Beispiel: Die SerializableContent -Eigenschaft ist auf "*" festgelegt. BackColor" und die -Eigenschaft auf festgelegt sind, werden alle B-Eigenschaften mit Ausnahme von NonSerializableContent BackColor ackColor ChartArea -Objekten serialisiert.

Wenn Sie die Content -Eigenschaft festlegen, SerializableContent wird die Eigenschaft intern festgelegt. Wenn die Eigenschaft bereits festgelegt ist, aber eine andere Eigenschaft serialisiert werden muss, stellen Sie sicher, dass Sie die Eigenschaft verketten, wenn Sie Content SerializableContent diese zusätzliche Eigenschaft angeben. Im folgenden Beispielcode finden Sie ein Beispiel für dieses Verfahren.

Diese Eigenschaft wirkt sich auf alle Speicher-, Lade- und Zurücksetzungsvorgänge aus.