DataPointCollection.AddY 方法

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

使用指定的 Y 值，將 DataPoint 物件加入至集合的結尾。

多載

AddY(Double)	使用指定的 Y 值，將 DataPoint 物件加入至集合的結尾。
AddY(Object[])	使用指定的 Y 值，將 DataPoint 物件加入至集合的結尾。

AddY(Double)

使用指定的 Y 值，將 DataPoint 物件加入至集合的結尾。

public:
 int AddY(double yValue);

public int AddY (double yValue);

member this.AddY : double -> int

Public Function AddY (yValue As Double) As Integer

參數

yValue

Double

資料點的 Y 值。

傳回

Int32

表示以零起始之索引的 integer，此索引是項目在資料點集合中的插入位置。

備註

這個方法會將一個 DataPoint 物件新增至 DataPointCollection ;資料點一律會加入至集合結尾。

如果您的資料點需要一個以上的 Y 值，請使用允許 Y 值陣列的方法定義。

如果您的資料點需要 X 值，也就是說，如果您要建立散佈圖，請改用其中 AddXY 一種方法。

AddY(Object[])

使用指定的 Y 值，將 DataPoint 物件加入至集合的結尾。

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

參數

yValue

Object[]

要加入到集合中並以逗號分隔之 DataPoint 物件的 Y 值清單。

傳回

Int32

integer，表示以零起始的索引位置，也就是項目在集合中的插入位置。

備註

這個方法會將一個 DataPoint 物件新增至 DataPointCollection ;資料點一律會加入至集合結尾。

您必須至少提供一個 (1) Y 值，否則會擲回例外狀況。 這個方法也會檢查 ChartType 這個資料所屬物件的 DataPoint 屬性;如果指定太多 Y 值，則會擲回例外狀況。

X 值一律會設定為零 (0) ，導致非散佈圖。 如果您想要讓資料點使用 X 值，請改為呼叫其中 AddXY 一個方法。

若要讓 DateTime 格式設定有效果，值必須是 DateTime 物件。

如需可用於物件類型參數的有效.NET Framework類型完整清單，請參閱下列內容：

String	Datetime	Double
Decimal	Single	Int32
UInt32	Int64	UInt64