ChartSerializer.SerializableContent Eigenschaft

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.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 Diagramm Eigenschaften serialisiert, wenn die Save -Methode und die- Load Methode aufgerufen werden. Sie können die NonSerializableContent -Eigenschaft verwenden, um die zu serialisierenden Diagramm Merkmale zusammen mit den SerializableContent -und- Content Eigenschaften einzuschränken.

Die- SerializableContent Eigenschaft bestimmt, welche Diagramm Merkmale serialisiert werden. Platzhalter können im Zeichen folgen Ausdruck auf die gleiche Weise wie die-Eigenschaft verwendet werden NonSerializableContent . Wenn Sie z. b. alle Diagramm Eigenschaften serialisieren möchten BackColor , legen Sie diese Eigenschaft auf "*" fest. BackColor ".

Wenn ChartArea die untergeordneten Eigenschaften und/oder Series angegeben werden, müssen die Namen aller ChartArea -und- Series Objekte ebenfalls angegeben werden, damit die beibehaltenen Daten auf vorhandene-Objekte und-Objekte angewendet werden können, d ChartArea . h Series ., Sie müssen die Ausdrücke "Series.Name" und "ChartArea.Name" angeben. Ein Beispiel für diese Prozedur finden Sie im folgenden Beispielcode. Ebenso muss, wenn mehrere Diagramm Flächen verwendet werden, auch die- ChartArea Eigenschaft aller geplotteten Diagramme Series gespeichert werden.

Manchmal kann eine Eigenschaft so festgelegt werden, dass Sie serialisiert und nicht serialisiert wird. Dies ist bei Verwendung von Platzhaltern üblich. NonSerializableContentIm Vergleich zum Ausdruck hat der Ausdruck eine niedrigere Priorität SerializableContent . Beachten Sie jedoch, dass Zeichen folgen Ausdrücken, die Platzhalter verwenden, weniger Gewicht eingeräumt wird. Wenn beispielsweise die- SerializableContent Eigenschaft auf "*" festgelegt ist. BackColor "und die- NonSerializableContent Eigenschaft auf festgelegt ist BackColor , werden alle B- ackColor Eigenschaften mit Ausnahme von ChartArea Objekten serialisiert.

Wenn Sie die- Content Eigenschaft festlegen, SerializableContent wird die-Eigenschaft intern festgelegt. Wenn die Content Eigenschaft bereits festgelegt ist, aber eine andere Eigenschaft serialisiert werden muss, stellen Sie sicher, SerializableContent dass die Eigenschaft beim Angeben dieser zusätzlichen Eigenschaft verkettet wird. Ein Beispiel für diese Prozedur finden Sie im folgenden Beispielcode.

Diese Eigenschaft wirkt sich auf alle Vorgänge zum Speichern, laden und zurücksetzen aus.