ChartSerializer.SerializableContent Propiedad

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Obtiene o establece las propiedades de gráfico que se pueden serializar.

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

Valor de propiedad

String

Expresión string separada por comas que representa las propiedades de gráfico que se van a serializar. La sintaxis es "Clase.Propiedad[,Clase.Propiedad]".

Comentarios

De forma predeterminada, todas las propiedades del gráfico se serializarán cuando se llame a los Save métodos y Load . Puede usar la propiedad para limitar las NonSerializableContent características del gráfico que se van a serializar, junto con las SerializableContent propiedades y Content .

La SerializableContent propiedad determina qué características del gráfico se serializarán. Los caracteres comodín se pueden usar en la expresión de cadena, de la misma manera que la NonSerializableContent propiedad . Por ejemplo, para serializar todas las propiedades del gráfico BackColor , establezca esta propiedad en "*. BackColor".

Si ChartArea se especifican o Series propiedades secundarias, también se deben especificar los nombres de todos los ChartArea objetos y Series para permitir que los datos persistentes se apliquen a los objetos y Series existentesChartArea; es decir, debe especificar expresiones "Series.Name" y "ChartArea.Name". Consulte el código de ejemplo siguiente para obtener un ejemplo de este procedimiento. De forma similar, si se usan varias áreas de gráfico, también se debe guardar la ChartArea propiedad de todos los trazados Series .

A veces, se puede establecer una propiedad para serializarse y no serializarse, lo que es común cuando se usan caracteres comodín. La NonSerializableContent expresión tiene una prioridad más baja en comparación con la SerializableContent expresión. Sin embargo, tenga en cuenta que se asigna menos peso a las expresiones de cadena que usan caracteres comodín. Por ejemplo, si la SerializableContent propiedad se establece en "*. BackColor" y la NonSerializableContent propiedad se establece BackColoren , todas las propiedades BackColor excepto los ChartArea objetos se serializarán.

Si establece la Content propiedad , la SerializableContent propiedad se establecerá internamente. Si la Content propiedad ya está establecida, pero es necesario serializar otra propiedad, asegúrese de concatenar la SerializableContent propiedad al especificar esa propiedad adicional. Consulte el código de ejemplo siguiente para obtener un ejemplo de este procedimiento.

Esta propiedad afecta a todas las operaciones de guardado, carga y restablecimiento.