CustomProperties.SetValue(String, String) Method

Records or clears a custom property value. This method doesn’t save your action to the Dashboard Designer’s history.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v20.2.Core.dll

NuGet Packages: DevExpress.Dashboard.Core, DevExpress.WindowsDesktop.Dashboard.Core

Declaration

C#

public void SetValue(
    string propertyName,
    string propertyValue
)

VB.NET

Public Sub SetValue(
    propertyName As String,
    propertyValue As String
)

Parameters

Name	Type	Description
propertyName	String	A String that specifies a custom property name.
propertyValue	String	A String that specifies a custom property value.

Remarks

You can add a new property or update an existing property’s value in the dashboard definition. Custom properties are stored in the CustomProperties collection in a structured format. Each custom property in this collection contains the custom property’s unique name and value.

The following table lists the levels and corresponding properties used to access the collection at this level:

Level to apply	Description	Property	Example
Dashboard	Stores custom data related to the dashboard.	Dashboard.CustomProperties	Dashboard description
Dashboard item	Stores custom data related to a particular dashboard item.	DashboardItem.CustomProperties	Chart - Scale break Chart - Constant line
Data item container	Stores custom data related to the Grid’s columns, the Chart’s series and other elements of a dashboard item.	DataItemContainer.CustomProperties	Grid - Fixed (Pinned) columns

The code snippet below saves a new value for the DashboardDescription property:

C#

designer.Dashboard.CustomProperties.SetValue("DashboardDescription", "New custom description");

VB.NET

designer.Dashboard.CustomProperties.SetValue("DashboardDescription", "New custom description")

The custom property’s value is stored as a string. For example, a dashboard XML file stores the DashboardDescription property at the dashboard’s level. The property’s value is used as the dashboard’s description.

<Dashboard>
...
    <CustomProperties>
        <DashboardDescription>This dashboard shows statistics on sales of bicycles, related equipment and accessories. ...</DashboardDescription>
    </CustomProperties>
</Dashboard>

To clear a custom property value, pass null to the CustomProperties.SetValue method.

The following code snippet clears the value of the DashboardDescription property:

C#

designer.Dashboard.CustomProperties.SetValue("DashboardDescription", null);

VB.NET

designer.Dashboard.CustomProperties.SetValue("DashboardDescription", Nothing)

Refer to the Custom Properties topic for details.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SetValue(String, String) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

WinForms-Dashboard-Viewer-DashboardStateChanged-Event/CS/WinForms-Dashboard-State-Changed-event/Form1.cs#L19

    var stateValue = state.SaveToXml().ToString(SaveOptions.DisableFormatting);
    dashboardViewer.Dashboard.CustomProperties.SetValue("DashboardState", stateValue);
}

winforms-dashboard-save-restore-dashboard-state/CS/WinFormsDashboard_DashboardState/Form1.cs#L58

var stateValue = state.SaveToXml().ToString(SaveOptions.DisableFormatting);
dashboardViewer1.Dashboard.CustomProperties.SetValue("DashboardState", stateValue);
dashboardViewer1.Dashboard.SaveToXml(path);

winforms-designer-save-and-apply-dashboard-state/CS/WinDesignerDashboardState/DesignerForm1.cs#L35

var stateValue = dState.SaveToXml().ToString(SaveOptions.DisableFormatting);
dashboardDesigner.Dashboard.CustomProperties.SetValue("DashboardState", stateValue);
dashboardDesigner.Dashboard.SaveToXml(path);

winforms-viewer-save-and-apply-dashboard-state/CS/WinFormsViewerSaveAndApplyDashboarState/ViewerForm1.cs#L36

var stateValue = dState.SaveToXml().ToString(SaveOptions.DisableFormatting);
dashboardViewer.Dashboard.CustomProperties.SetValue("DashboardState", stateValue);
dashboardViewer.Dashboard.SaveToXml(path);

WinForms-Dashboard-How-to-Highlight-Data-in-the-Scatter-Chart-Dashboard-Item/CS/ChartFormatRulesSample/Form1.cs#L32

    ScatterChartConstantLineUserData moduleData = new ScatterChartConstantLineUserData() { Enabled = true, VerticalAxisValue = discountThreshold, HorizontalAxisValue = unitCountThreshold };
    scatterChart.CustomProperties.SetValue(ScatterChartConstantLineUserValueModule.PropertyName, moduleData.GetStringFromData());
}

VB.NET

WinForms-Dashboard-Viewer-DashboardStateChanged-Event/VB/WinForms-Dashboard-State-Changed-event/Form1.vb#L20

    Dim stateValue = state.SaveToXml().ToString(SaveOptions.DisableFormatting)
    dashboardViewer.Dashboard.CustomProperties.SetValue("DashboardState", stateValue)
End Sub

winforms-dashboard-save-restore-dashboard-state/VB/WinFormsDashboard_DashboardState/Form1.vb#L49

Dim stateValue = state.SaveToXml().ToString(SaveOptions.DisableFormatting)
dashboardViewer1.Dashboard.CustomProperties.SetValue("DashboardState", stateValue)
dashboardViewer1.Dashboard.SaveToXml(path)

winforms-designer-save-and-apply-dashboard-state/VB/WinDesignerDashboardState/DesignerForm1.vb#L34

Dim stateValue = dState.SaveToXml().ToString(SaveOptions.DisableFormatting)
dashboardDesigner.Dashboard.CustomProperties.SetValue("DashboardState", stateValue)
dashboardDesigner.Dashboard.SaveToXml(path)

winforms-viewer-save-and-apply-dashboard-state/VB/WinFormsViewerSaveAndApplyDashboarState/ViewerForm1.vb#L35

Dim stateValue = dState.SaveToXml().ToString(SaveOptions.DisableFormatting)
dashboardViewer.Dashboard.CustomProperties.SetValue("DashboardState", stateValue)
dashboardViewer.Dashboard.SaveToXml(path)

WinForms-Dashboard-How-to-Highlight-Data-in-the-Scatter-Chart-Dashboard-Item/VB/ChartFormatRulesSample/Form1.vb#L32

    Dim moduleData As New ScatterChartConstantLineUserData() With {.Enabled = True, .VerticalAxisValue = discountThreshold, .HorizontalAxisValue = unitCountThreshold}
    scatterChart.CustomProperties.SetValue(ScatterChartConstantLineUserValueModule.PropertyName, moduleData.GetStringFromData())
End Sub