ListObject.Name 屬性
取得或設定 ListObject 控制項的名稱。
命名空間: Microsoft.Office.Tools.Excel
組件: Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)
語法
'宣告
Property Name As String
string Name { get; set; }
屬性值
型別:System.String
ListObject 控制項的名稱。
備註
這個名稱只用來做為 Microsoft.Office.Interop.Excel.ListObjects 集合之 ListObjects.Item 屬性的唯一識別項。 這個屬性只能透過物件模型設定。
根據預設,每個 ListObject 控制項名稱以單字 "List" 開頭,之後跟隨一個數字 (中間沒有空格)。 如果嘗試將 Name 屬性設定為另一個 ListObject 控制項已經使用的名稱,則會擲回例外狀況。
範例
下列程式碼範例會在目前的工作表中建立 ListObject,然後使用 Name 屬性,將 ListObject 的名稱設定為 "Employees"。
這是示範文件層級自訂的範例。
Private Sub ListObject_Metadata()
Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
Me.Controls.AddListObject(Me.Range("A1", "D4"), "Employees")
List1.Name = "Employees"
List1.Tag = "Employee data"
MessageBox.Show("The list name is " + List1.Name.ToString() & _
" and the tag is " & List1.Tag.ToString() + ".")
End Sub
private void ListObject_Metadata()
{
Microsoft.Office.Tools.Excel.ListObject list1 =
this.Controls.AddListObject(this.Range["A1", "D4"], "Employees");
list1.Name = "Employees";
list1.Tag = "Employee data";
MessageBox.Show("The list name is " + list1.Name.ToString() +
" and the tag is " + list1.Tag.ToString() + ".");
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。