Keywords (Chart Controls)
In the Chart control, a keyword is a character sequence that is replaced with an automatically calculated value at run time.
Applicable Chart Elements
Keywords apply to the following chart elements.
| Element | Applicable Properties |
|---|---|
Series and DataPoint |
|
Annotation |
|
Legend |
|
Keyword Reference
The following table lists all keywords the Chart control accepts.
| Keyword | Description | Multiple Y Values | Formatting |
|---|---|---|---|
#VALX |
X value of data point. |
No |
Yes |
#VAL |
Y values of the data point. |
Yes |
Yes |
#SERIESNAME |
Series name. |
No |
No |
#LABEL |
Data point label. |
No |
No |
#AXISLABEL |
Axis data point label. |
No |
No |
#INDEX |
Data point index. |
No |
Yes |
#PERCENT |
Percentage of the data point Y value. |
Yes |
Yes |
#LEGENDTEXT |
Legend text. |
No |
No |
#CUSTOMPROPERTY(customAttributeName) |
Value of the named custom attribute. |
No |
No |
#TOTAL |
Total of all Y values in the series. |
Yes |
Yes |
#AVG |
Average of all Y values in the series. |
Yes |
Yes |
#MIN |
Minimum data point of all Y values in the series. |
Yes |
Yes |
#MAX |
Maximum data point of all Y values in the series. |
Yes |
Yes |
#FIRST |
First data point of all Y values in the series. |
Yes |
Yes |
#LAST |
Last data point of all Y values in the series. |
Yes |
Yes |
Using Keywords with Multiple Y Values
When using chart types with more than one Y value, you can show calculation specific to a Y value in certain keywords. To do this, append the Y value position to the keyword. For example, to show the open, close, high, and low values in a stock chart, use the following string: "#VALY, #VALY2, #VALY3, #VALY4".
Formatting Keywords
Certain keywords allow formatting. To format the output of a keyword, at the end of the keyword, add a standard numeric format string or custom numeric format string encapsulated in curly brackets.
When you use a standard numeric format string, the Chart control uses the regional settings on your system to display the calculated values in the local format (such as the Japanese Yen for currency).
For example:
To represent Y values as currency, use "#VAL{C}".
To represent positive Y values as dollars with negative values shown as positive dollars encapsulated by parentheses, use "#VAL{$#,##0.00;($#,##0.00)}".
For more information, see Numeric Format Strings.
See Also
Reference
System.Windows.Forms.DataVisualization.Charting
System.Web.UI.DataVisualization.Charting