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 控件。
异常
| 异常 | 条件 |
|---|---|
| ArgumentNullException | 名称参数或范围参数为 nullnull 引用（在 Visual Basic 中为 Nothing），或者名称参数长度为零。 |
| ControlNameAlreadyExistsException | ControlCollection 实例中已存在一个同名控件。 |
| InvalidRangeException | 指定的范围无效。 不能使用多区域范围。 该范围应与 ControlCollection 实例同在一个工作表中。 |
备注
使用 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。