DataPoint Class
Definition
Represents a data point that is stored in the DataPointCollection class.
public ref class DataPoint : System::Web::UI::DataVisualization::Charting::DataPointCustomProperties[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataVisualization.Charting.DataPointConverter, System.Web.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]
[System.Web.UI.Themeable(false)]
public class DataPoint : System.Web.UI.DataVisualization.Charting.DataPointCustomPropertiestype DataPoint = class
inherit DataPointCustomPropertiesPublic Class DataPoint
Inherits DataPointCustomProperties- Inheritance
- Attributes
Remarks
The DataPoint class stores properties associated with data as well as data point values. For example, a data point has a value, but it also has a color property, background image property, background gradient property, and so forth. For more information about data point properties, see the DataPointCustomProperties class overview topic.
Each data point consists of an X-value and one or more Y-values. The X-value can be zero, or you can set this explicitly.
Only one Y-value per point is required for all chart types except bubble, candlestick and stock charts. These chart types require more than one Y-value because one data point consists of multiple values. For example, to plot one stock chart column, four values are required: high, low, open and close values.
Data can be added at either design time or run time; you can also use data-binding at run time.
Constructors
| DataPoint() |
Initializes a new instance of the DataPoint class. |
| DataPoint(Double, Double) |
Initializes a new instance of the DataPoint class with the specified X and Y-value. |
| DataPoint(Double, Double[]) |
Initializes a new instance of the DataPoint class with the specified X-value and an array of Y-values. |
| DataPoint(Double, String) |
Initializes a new instance of the DataPoint class with the specified X-value and Y-values. |
| DataPoint(Series) |
Initializes a new instance of the DataPoint class, and sets the Series that the data point belongs to. |
Properties
| AxisLabel |
Gets or sets the text of the X-axis label for the data point, series or an empty point. This property is only used if a custom label has not been specified for the relevant Axis object. (Inherited from DataPointCustomProperties) |
| BackGradientStyle |
Gets or sets the background gradient style. (Inherited from DataPointCustomProperties) |
| BackHatchStyle |
Gets or sets the background hatching style. (Inherited from DataPointCustomProperties) |
| BackImage |
Gets or sets the background image of the data point. (Inherited from DataPointCustomProperties) |
| BackImageAlignment |
Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode. (Inherited from DataPointCustomProperties) |
| BackImageTransparentColor |
Gets or sets a color that will be replaced with a transparent color when the background image is drawn. (Inherited from DataPointCustomProperties) |
| BackImageWrapMode |
Gets or sets the drawing mode of the background image. (Inherited from DataPointCustomProperties) |
| BackSecondaryColor |
Gets or sets the secondary background color. (Inherited from DataPointCustomProperties) |
| BorderColor |
Gets or sets the border color of the data point. (Inherited from DataPointCustomProperties) |
| BorderDashStyle |
Gets or sets the border style of the data point. (Inherited from DataPointCustomProperties) |
| BorderWidth |
Gets or sets the border width of the data point. (Inherited from DataPointCustomProperties) |
| Color |
Gets or sets the color of the data point. (Inherited from DataPointCustomProperties) |
| CustomProperties |
Gets or sets the custom properties of the data point. Custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2, ... (Inherited from DataPointCustomProperties) |
| CustomPropertiesExtended |
Gets or sets the extended custom properties of the data point. (Inherited from DataPointCustomProperties) |
| Font |
Gets or sets the font of the data point. (Inherited from DataPointCustomProperties) |
| IsEmpty |
Gets or sets a flag that indicates whether a data point is marked as empty. |
| IsValueShownAsLabel |
Gets or sets a flag that indicates whether to show the value of the data point on the label. (Inherited from DataPointCustomProperties) |
| IsVisibleInLegend |
Gets or sets a flag that indicates whether the item is shown in the legend. (Inherited from DataPointCustomProperties) |
| Item[Int32] |
Gets the DataPointCustomProperties object by its position in the collection. (Inherited from DataPointCustomProperties) |
| Item[String] |
Gets or sets the DataPointCustomProperties object by name. (Inherited from DataPointCustomProperties) |
| Label |
Gets or sets the text of the data point label. (Inherited from DataPointCustomProperties) |
| LabelAngle |
Gets or sets the angle of the data point label. (Inherited from DataPointCustomProperties) |
| LabelBackColor |
Gets or sets the background color of the data point label. (Inherited from DataPointCustomProperties) |
| LabelBorderColor |
Gets or sets the border color of the data point label. (Inherited from DataPointCustomProperties) |
| LabelBorderDashStyle |
Gets or sets the border style of the label. (Inherited from DataPointCustomProperties) |
| LabelBorderWidth |
Gets or sets the width of the label border. (Inherited from DataPointCustomProperties) |
| LabelForeColor |
Gets or sets the text color of the label. (Inherited from DataPointCustomProperties) |
| LabelFormat |
Gets or sets the format of the data point label. (Inherited from DataPointCustomProperties) |
| LabelMapAreaAttributes |
Gets or sets the map area attributes of the data point label. (Inherited from DataPointCustomProperties) |
| LabelPostBackValue |
Gets or sets the postback value which can be processed on a Click event. (Inherited from DataPointCustomProperties) |
| LabelToolTip |
Gets or sets the tooltip for the data point label. (Inherited from DataPointCustomProperties) |
| LabelUrl |
Gets or sets the URL target of the data point label. (Inherited from DataPointCustomProperties) |
| LegendMapAreaAttributes |
Gets or sets the attributes of the legend map area. (Inherited from DataPointCustomProperties) |
| LegendPostBackValue |
Gets or sets the postback value which can be processed on a Click event. (Inherited from DataPointCustomProperties) |
| LegendText |
Gets or sets the text of the item in the legend. (Inherited from DataPointCustomProperties) |
| LegendToolTip |
Gets or sets the tooltip of the item in the legend. (Inherited from DataPointCustomProperties) |
| LegendUrl |
Gets or sets the URL target of the item in the legend. (Inherited from DataPointCustomProperties) |
| MapAreaAttributes |
Gets or sets the map area attributes of a data point. (Inherited from DataPointCustomProperties) |
| MarkerBorderColor |
Gets or sets the border color of the marker. (Inherited from DataPointCustomProperties) |
| MarkerBorderWidth |
Gets or sets the border width of the marker. (Inherited from DataPointCustomProperties) |
| MarkerColor |
Gets or sets the marker color. (Inherited from DataPointCustomProperties) |
| MarkerImage |
Gets or sets the marker image. (Inherited from DataPointCustomProperties) |
| MarkerImageTransparentColor |
Gets or sets the color that will be replaced with a transparent color when the marker image is drawn. (Inherited from DataPointCustomProperties) |
| MarkerSize |
Gets or sets the size of the marker. (Inherited from DataPointCustomProperties) |
| MarkerStyle |
Gets or sets the marker style. (Inherited from DataPointCustomProperties) |
| Name |
Gets or sets the name of the data point. |
| PostBackValue |
Gets or sets the postback value that can be processed on a Click event. (Inherited from DataPointCustomProperties) |
| Tag |
Gets or sets an object associated with this chart element. (Inherited from ChartElement) |
| ToolTip |
Gets or sets the tooltip of the data point. (Inherited from DataPointCustomProperties) |
| Url |
Gets or sets the URL target of the area. (Inherited from DataPointCustomProperties) |
| XValue |
Gets or sets the X-value of a data point. |
| YValues |
Gets or sets the Y-value(s) of a data point. |
Methods
| Clone() |
Returns an exact copy of the data point. |
| DeleteCustomProperty(String) |
Deletes the data point custom property with the specified name. (Inherited from DataPointCustomProperties) |
| Dispose() |
Releases the resources used by the ChartElement. (Inherited from ChartElement) |
| Dispose(Boolean) |
Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources. (Inherited from ChartElement) |
| Equals(Object) |
Determines whether the specified Object is equal to the current ChartElement. (Inherited from ChartElement) |
| GetCustomProperty(String) |
Returns the data point custom property with the specified name. (Inherited from DataPointCustomProperties) |
| GetHashCode() |
Returns a hash function for a particular type. (Inherited from ChartElement) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| GetValueByName(String) |
Returns a data point that is specified by its name. This is a helper function. |
| IsCustomPropertySet(String) |
Determines whether a custom property with the specified name was set. (Inherited from DataPointCustomProperties) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| ResetIsValueShownAsLabel() |
Resets the IsValueShownAsLabel property to its default value. (Inherited from DataPointCustomProperties) |
| ResetIsVisibleInLegend() |
Resets the IsVisibleInLegend property to its default value. (Inherited from DataPointCustomProperties) |
| SetCustomProperty(String, String) |
Sets a custom property of the data point. (Inherited from DataPointCustomProperties) |
| SetDefault(Boolean) |
Sets the default properties of the data point. Indicates whether the previous property values must be cleared. (Inherited from DataPointCustomProperties) |
| SetValueXY(Object, Object[]) |
Sets the X-value and one or more Y-values of the data point. |
| SetValueY(Object[]) |
Sets the Y-value(s) of a single data point. |
| ToString() |
Returns a string that represents the current Object. (Inherited from ChartElement) |