ControlCollection.AddChart 方法 (Range, String)

將新的 Chart 控制項加入至工作表中指定的範圍。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function AddChart ( _
    range As Range, _
    name As String _
) As Chart

Chart AddChart(
    Range range,
    string name
)

參數

• range
  型別：Microsoft.Office.Interop.Excel.Range
  提供控制項繫結的 Range。

• name
  型別：System.String
  可於 ControlCollection 執行個體中用於索引控制項的控制項名稱。

傳回值

型別：Microsoft.Office.Tools.Excel.Chart
加入 ControlCollection 執行個體的 Chart 控制項中。

例外狀況

備註

AddChart 方法可以用來將 Chart 控制項加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 Chart 控制項，請使用 Remove 方法。

範例

下列程式碼範例會將數字 16 插入儲存格 E1 至 E3，以及將數字 24 加入至 F1 至 F3。 然後程式碼會在儲存格 A1 至 C8 建立一個 Chart 控制項，並將儲存格 E1 至 F3 傳遞至 SetSourceData 方法，將資料填入圖表。

Private Sub ExcelAddRangeChart()
    Me.Range("E1", "E3").Value2 = 16
    Me.Range("F1", "F3").Value2 = 24

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
        = Me.Controls.AddChart(Me.Range("A1", "C8"), _
        "Chart1")

    Chart1.SetSourceData(Me.Range("E1", "F5"), _
        Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType. _
        xlColumnClustered

End Sub 

private void ExcelAddRangeChart()
{
    this.Range["E1", "E3"].Value2 = 16;
    this.Range["F1", "F3"].Value2 = 24;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");

    chart1.SetSourceData(this.Range["E1", "F5"], Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

ControlCollection 介面

AddChart 多載

Microsoft.Office.Tools.Excel 命名空間