自定义属性(图表控件)

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

提示

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

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

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

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

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

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

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

有关每个自定义属性的更多信息(包括示例),请参见自定义属性列表

访问自定义属性

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

SeriesDataPoint 对象提供了其他一些方法用于访问自定义属性。例如:IsCustomPropertySetSetCustomPropertySetCustomPropertyDeleteCustomProperty

下面的代码访问一个饼图的 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

其他资源

自定义属性列表