通过

自定义属性

  • 项目

图表控件中的每个图表类型都包含一组自定义属性。使用自定义属性可以自定义图表的外观。这些属性可使用 Series 对象及其关联 DataPoint 对象的 CustomProperties 属性来实现。

备注

每个自定义属性都适用于一组特定的图表类型。

图表控件自定义属性具有以下特征：

  • 根据图表类型，您可以将适用的自定义属性设置为图表的 Series 对象和/或其关联 DataPoint 对象。如果某个自定义属性同时适用于图表的 Series 和 DataPoint 对象，则为序列设置的任何自定义属性都适用于该序列包含的所有数据点。

  • 适用于 DataPoint 对象的自定义属性的优先级高于适用于 Series 对象的自定义属性。如果为某个 Series 对象及该对象的一个 DataPoint 对象设置了同一个自定义属性，则该 DataPoint 对象的设置优先。

  • 自定义属性名称区分大小写。

  • 自定义属性值是字符串。

  • 如果自定义属性的值包含逗号，则必须在每个逗号前加一个转义字符“\”。

有关每个自定义属性的更多信息（包括示例），请参见自定义属性列表。

访问自定义属性

自定义属性在 Visual Studio 的“属性”窗口中不可见。若要以编程方式访问自定义属性，不需要指定 CustomProperties 属性。将一个索引器添加到 Series 或 DataPoint 对象，然后将自定义属性的名称用作索引，即可获取和设置特定名称/值对。通过这种方法，可以只访问该特定自定义属性。

Series 和 DataPoint 对象提供了其他一些方法用于访问自定义属性。例如：IsCustomPropertySet、SetCustomProperty、SetCustomProperty 和 DeleteCustomProperty。

下面的代码访问一个饼图的 DataPoint 对象中的 Exploded 自定义属性，并将其设置为 True，然后检查其值：

' Explode the first pie slice
Chart1.Series("Default").Points(0)("Exploded") = "True"
…
' Check if the the first pie slice is still exploded
If Chart1.Series("Default").Points(0)("Exploded") = "True"
    ' Do something
End If

// Explode the first pie slice
Chart1.Series["Default"].Points[0]["Exploded"] = "True"
…
// Check if the the first pie slice is still exploded
if (Chart1.Series["Default"].Points[0]["Exploded"] == "True")
{
    //Do something
}

请参阅

参考

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

概念

自定义属性列表