Edit

Share via

DataPointCollection.AddY Method

  • Reference

Definition

Namespace:
System.Windows.Forms.DataVisualization.Charting
Assembly:
System.Windows.Forms.DataVisualization.dll

Adds a DataPoint object to the end of the collection, with the specified Y-value.

Overloads

AddY(Double)

Adds a DataPoint object to the end of the collection, with the specified Y-value.
AddY(Object[])

Adds a DataPoint object to the end of the collection, with the specified Y-value(s).

AddY(Double)

Adds a DataPoint object to the end of the collection, with the specified Y-value.

public:
 int AddY(double yValue);
public int AddY (double yValue);
member this.AddY : double -> int
Public Function AddY (yValue As Double) As Integer

Parameters

yValue
Double

The Y-value of the data point.

Returns

Int32

An integer that represents the zero-based index where the item was inserted into the data point collection.

Remarks

This method adds one DataPoint object to the DataPointCollection; the data point is always added to the end of the collection.

Use the method definition that allows for an array of Y-values if your data points require more than one Y-value.

If your data points need an X-value - that is, if you are creating scatter plots - use one of the AddXY methods instead.

Applies to

AddY(Object[])

Adds a DataPoint object to the end of the collection, with the specified Y-value(s).

public:
 int AddY(... cli::array <System::Object ^> ^ yValue);
public int AddY (params object[] yValue);
member this.AddY : obj[] -> int
Public Function AddY (ParamArray yValue As Object()) As Integer

Parameters

yValue
Object[]

A comma-separated list of Y-value(s) of the DataPoint object added to the collection.

Returns

Int32

An integer that represents the location in zero-based index where the item was inserted into the collection.

Remarks

This method adds one DataPoint object to the DataPointCollection; the data point is always added to the end of the collection.

You must provide at least one (1) Y-value, otherwise an exception will be thrown. This method also checks the ChartType property of the DataPoint object this data belongs to; if too many Y-values are specified, an exception will be thrown.

The X-value will always be set to zero (0), resulting in non-scatter plots. If you want the data points to use an X-value, call one of the AddXY methods instead.

In order for DateTime formatting to have an effect, a value must be a DateTime object.

Refer to the following for a complete listing of valid .NET Framework types that can be used for the object type parameters:
String DateTime Double
Decimal Single Int32
UInt32 Int64 UInt64

Applies to