ControlCollection.AddListObject 方法 (Range, String)
在工作表中的指定范围添加一个新的 ListObject 控件。
命名空间： Microsoft.Office.Tools.Excel
程序集： Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）
语法
声明
Function AddListObject ( _
range As Range, _
name As String _
) As ListObject
ListObject AddListObject(
Range range,
string name
)
参数
- range
类型：Microsoft.Office.Interop.Excel.Range
提供控件的边界的 Range。
- name
类型：System.String
可用于索引 ControlCollection 实例中控件的控件名称。
返回值
类型：Microsoft.Office.Tools.Excel.ListObject
添加到 ControlCollection 实例的 ListObject 控件。
异常
| 异常 | 条件 |
|---|---|
| ArgumentNullException | 名称参数或范围参数为 nullnull 引用（在 Visual Basic 中为 Nothing），或者名称参数长度为零。 |
| ControlNameAlreadyExistsException | ControlCollection 实例中已存在一个同名控件。 |
| InvalidRangeException | 指定的范围无效。 不能使用多区域范围。 该范围应与 ControlCollection 实例同在一个工作表中。 |
备注
使用 AddListObject 方法可以将 ListObject 控件添加到 ControlCollection 的末尾。 若要移除以前以编程方式添加的 ListObject 控件，请使用 Remove 方法。
示例
下面的代码示例将一个 ListObject 控件添加到工作表顶端，然后显示一个消息框，在其中显示 ListObject 中的行数。
Private Sub ExcelAddListObject()
Dim List1 As Microsoft.Office.Tools.Excel. _
ListObject = Me.Controls.AddListObject( _
Me.Range("A1", "C5"), "List1")
MessageBox.Show("The list object has " _
& List1.Range.Rows.Count.ToString() + " rows.")
End Sub
private void ExcelAddListObject()
{
Microsoft.Office.Tools.Excel.ListObject list1 =
this.Controls.AddListObject(this.Range["A1", "C5"],
"list1");
MessageBox.Show("The list object has " +
list1.Range.Rows.Count.ToString() + " rows.");
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。