Export (0) Print
Expand All

DataPoint Class

Represents a data point that is stored in the DataPointCollection class.

Namespace:  System.Web.UI.DataVisualization.Charting
Assembly:  System.Web.DataVisualization (in System.Web.DataVisualization.dll)

[ThemeableAttribute(false)]
[TypeConverterAttribute("System.Web.UI.Design.DataVisualization.Charting.DataPointConverter, System.Web.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]
public class DataPoint : DataPointCustomProperties

The DataPoint type exposes the following members.

  NameDescription
Public methodDataPoint()Initializes a new instance of the DataPoint class.
Public methodDataPoint(Series)Initializes a new instance of the DataPoint class, and sets the Series that the data point belongs to.
Public methodDataPoint(Double, Double)Initializes a new instance of the DataPoint class with the specified X and Y-value.
Public methodDataPoint(Double, Double[])Initializes a new instance of the DataPoint class with the specified X-value and an array of Y-values.
Public methodDataPoint(Double, String)Initializes a new instance of the DataPoint class with the specified X-value and Y-values.
Top

  NameDescription
Public propertyAxisLabelGets 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.)
Public propertyBackGradientStyleGets or sets the background gradient style. (Inherited from DataPointCustomProperties.)
Public propertyBackHatchStyleGets or sets the background hatching style. (Inherited from DataPointCustomProperties.)
Public propertyBackImageGets or sets the background image of the data point. (Inherited from DataPointCustomProperties.)
Public propertyBackImageAlignmentGets or sets the alignment of the background image, which is used with the Unscaled drawing mode. (Inherited from DataPointCustomProperties.)
Public propertyBackImageTransparentColorGets or sets a color that will be replaced with a transparent color when the background image is drawn. (Inherited from DataPointCustomProperties.)
Public propertyBackImageWrapModeGets or sets the drawing mode of the background image. (Inherited from DataPointCustomProperties.)
Public propertyBackSecondaryColorGets or sets the secondary background color. (Inherited from DataPointCustomProperties.)
Public propertyBorderColorGets or sets the border color of the data point. (Inherited from DataPointCustomProperties.)
Public propertyBorderDashStyleGets or sets the border style of the data point. (Inherited from DataPointCustomProperties.)
Public propertyBorderWidthGets or sets the border width of the data point. (Inherited from DataPointCustomProperties.)
Public propertyColorGets or sets the color of the data point. (Inherited from DataPointCustomProperties.)
Public propertyCustomPropertiesGets 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.)
Public propertyCustomPropertiesExtendedInfrastructure. Gets or sets the extended custom properties of the data point. (Inherited from DataPointCustomProperties.)
Public propertyFontGets or sets the font of the data point. (Inherited from DataPointCustomProperties.)
Public propertyIsEmptyGets or sets a flag that indicates whether a data point is marked as empty.
Public propertyIsValueShownAsLabelGets or sets a flag that indicates whether to show the value of the data point on the label. (Inherited from DataPointCustomProperties.)
Public propertyIsVisibleInLegendGets or sets a flag that indicates whether the item is shown in the legend. (Inherited from DataPointCustomProperties.)
Public propertyItem[Int32]Gets the DataPointCustomProperties object by its position in the collection. (Inherited from DataPointCustomProperties.)
Public propertyItem[String]Gets or sets the DataPointCustomProperties object by name. (Inherited from DataPointCustomProperties.)
Public propertyLabelGets or sets the text of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelAngleGets or sets the angle of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelBackColorGets or sets the background color of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelBorderColorGets or sets the border color of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelBorderDashStyleGets or sets the border style of the label. (Inherited from DataPointCustomProperties.)
Public propertyLabelBorderWidthGets or sets the width of the label border. (Inherited from DataPointCustomProperties.)
Public propertyLabelForeColorGets or sets the text color of the label. (Inherited from DataPointCustomProperties.)
Public propertyLabelFormatGets or sets the format of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelMapAreaAttributesGets or sets the map area attributes of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelPostBackValueGets or sets the postback value which can be processed on a Click event. (Inherited from DataPointCustomProperties.)
Public propertyLabelToolTipGets or sets the tooltip for the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLabelUrlGets or sets the URL target of the data point label. (Inherited from DataPointCustomProperties.)
Public propertyLegendMapAreaAttributesGets or sets the attributes of the legend map area. (Inherited from DataPointCustomProperties.)
Public propertyLegendPostBackValueGets or sets the postback value which can be processed on a Click event. (Inherited from DataPointCustomProperties.)
Public propertyLegendTextGets or sets the text of the item in the legend. (Inherited from DataPointCustomProperties.)
Public propertyLegendToolTipGets or sets the tooltip of the item in the legend. (Inherited from DataPointCustomProperties.)
Public propertyLegendUrlGets or sets the URL target of the item in the legend. (Inherited from DataPointCustomProperties.)
Public propertyMapAreaAttributesGets or sets the map area attributes of a data point. (Inherited from DataPointCustomProperties.)
Public propertyMarkerBorderColorGets or sets the border color of the marker. (Inherited from DataPointCustomProperties.)
Public propertyMarkerBorderWidthGets or sets the border width of the marker. (Inherited from DataPointCustomProperties.)
Public propertyMarkerColorGets or sets the marker color. (Inherited from DataPointCustomProperties.)
Public propertyMarkerImageGets or sets the marker image. (Inherited from DataPointCustomProperties.)
Public propertyMarkerImageTransparentColorGets or sets the color that will be replaced with a transparent color when the marker image is drawn. (Inherited from DataPointCustomProperties.)
Public propertyMarkerSizeGets or sets the size of the marker. (Inherited from DataPointCustomProperties.)
Public propertyMarkerStyleGets or sets the marker style. (Inherited from DataPointCustomProperties.)
Public propertyNameGets or sets the name of the data point. (Overrides ChartNamedElement.Name.)
Public propertyPostBackValueGets or sets the postback value that can be processed on a Click event. (Inherited from DataPointCustomProperties.)
Public propertyTagGets or sets an object associated with this chart element. (Inherited from ChartElement.)
Public propertyToolTipGets or sets the tooltip of the data point. (Inherited from DataPointCustomProperties.)
Public propertyUrlGets or sets the URL target of the area. (Inherited from DataPointCustomProperties.)
Public propertyXValueGets or sets the X-value of a data point.
Public propertyYValuesGets or sets the Y-value(s) of a data point.
Top

  NameDescription
Public methodCloneReturns an exact copy of the data point.
Public methodDeleteCustomPropertyDeletes the data point custom property with the specified name. (Inherited from DataPointCustomProperties.)
Public methodDispose()Releases the resources used by the ChartElement. (Inherited from ChartElement.)
Protected methodDispose(Boolean)Releases the unmanaged resources used by the ChartElement and optionally releases the managed resources. (Inherited from ChartElement.)
Public methodEqualsDetermines whether the specified Object is equal to the current ChartElement. (Inherited from ChartElement.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetCustomPropertyReturns the data point custom property with the specified name. (Inherited from DataPointCustomProperties.)
Public methodGetHashCodeReturns a hash function for a particular type. (Inherited from ChartElement.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGetValueByNameReturns a data point that is specified by its name. This is a helper function.
Public methodIsCustomPropertySetDetermines whether a custom property with the specified name was set. (Inherited from DataPointCustomProperties.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodResetIsValueShownAsLabelResets the IsValueShownAsLabel property to its default value. (Inherited from DataPointCustomProperties.)
Public methodResetIsVisibleInLegendResets the IsVisibleInLegend property to its default value. (Inherited from DataPointCustomProperties.)
Public methodSetCustomPropertySets a custom property of the data point. (Inherited from DataPointCustomProperties.)
Public methodSetDefaultSets the default properties of the data point. Indicates whether the previous property values must be cleared. (Inherited from DataPointCustomProperties.)
Public methodSetValueXYSets the X-value and one or more Y-values of the data point.
Public methodSetValueYSets the Y-value(s) of a single data point.
Public methodToStringReturns a string that represents the current Object. (Inherited from ChartElement.)
Top

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.

.NET Framework

Supported in: 4.6, 4.5, 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft