DataPointCollection.AddY Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds a DataPoint object to the end of the collection, with the specified Y-value(s).
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
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
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 |