ChartSerializer.NonSerializableContent Eigenschaft

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Ruft die Diagrammeigenschaften ab, die nicht serialisiert werden, oder legt diese fest.

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

public string NonSerializableContent { get; set; }

member this.NonSerializableContent : string with get, set

Public Property NonSerializableContent As String

Eigenschaftswert

String

Ein durch Trennzeichen getrennter string-Ausdruck, der die Diagrammeigenschaften darstellt, die nicht serialisiert werden. 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.

Diese Eigenschaft bestimmt, welche Diagrammmerkmale nicht serialisiert werden. Platzhalter können im Zeichenfolgenausdruck auf die gleiche Weise wie die -Eigenschaft verwendet SerializableContent werden. Um beispielsweise alle Diagrammeigenschaften von der Serialisierung BackColor auszuschließen, legen Sie diese Eigenschaft auf * fest. BackColor".

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. Wenn die -Eigenschaft SerializableContent beispielsweise auf " festgelegt * ist. BackColor" und die -Eigenschaft auf festgelegt sind, werden alle Eigenschaften mit Ausnahme von NonSerializableContent BackColor BackColor ChartArea -Objekten serialisiert.

Wenn die Eigenschaft festgelegt wurde, hängt die Priorität davon ab, wie viele Content Platzhalter im Ausdruck verwendet NonSerializableContent werden. Wenn Sie z. B. Content die -Eigenschaft auf festlegen, führt Appearance dies dazu, dass die SerializableContent -Eigenschaft ein * enthält. Back * "-Ausdruck. Wenn die NonSerializableContent -Eigenschaft auf " festgelegt * ist. Zurück " werden alle Diagrammeigenschaften, z. B. * , Back\* usw., weiterhin BackColor BackGradient serialisiert. Dies liegt SerializableContent daran, dass der Eigenschaftswert im Vergleich zur -Eigenschaft eine höhere Priorität NonSerializableContent hat.

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