ControlCollection 介面

代表 Office 方案中 Excel 工作表上的 Managed 控制項集合。

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

語法

'宣告
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable

ControlCollection 型別會公開下列成員。

屬性

	名稱	說明
	Count	取得 ControlCollection 中的控制項數目。
	Item[Int32]	取得指定索引上的控制項。
	Item[String]	取得具有指定名稱的控制項。

回頁首

方法

	名稱	說明
	AddChart(Range, String)	將新的 Chart 控制項加入至工作表中指定的範圍。
	AddChart(Double, Double, Double, Double, String)	將新的 Chart 控制項依指定大小和位置加入至工作表。
	AddControl(Control, Range, String)	將指定的 Control 加入至 ControlCollection 的指定範圍。
	AddControl(Control, Double, Double, Double, Double, String)	將指定的 Control 依指定的位置和大小加入至 ControlCollection。
	AddListObject(ListObject)	將 Visual Studio Microsoft.Office.Tools.Excel.ListObject 加入以指定的原生 Microsoft.Office.Interop.Excel.ListObject 為根據的控制項集合。
	AddListObject(Range, String)	將新的 ListObject 控制項加入至工作表中指定的範圍。
	AddNamedRange	將新的 NamedRange 控制項加入至工作表中指定的範圍。
	Contains(Object)	判斷指定的控制項是否為 ControlCollection 執行個體的成員。
	Contains(String)	判斷具有指定之名稱的控制項是否為 ControlCollection 執行個體的成員。
	GetEnumerator	傳回會逐一查看集合的列舉程式。 (繼承自 IEnumerable)。
	IndexOf(Object)	在 ControlCollection 執行個體中搜尋指定的控制項，並傳回第一次出現的位置索引 (以零起始)。
	IndexOf(String)	搜尋 ControlCollection 執行個體中，具有指定之名稱的控制項第一次出現的位置。
	Remove(Object)	從 ControlCollection 執行個體中移除指定的控制項。
	Remove(String)	從 ControlCollection 執行個體中移除具有指定之名稱的控制項。
	RemoveAt	從 ControlCollection 執行個體中移除指定之索引的控制項。

回頁首

備註

使用 ControlCollection 介面的方法和屬性管理 Excel 工作表上的控制項。 如需詳細資訊，請參閱在執行階段將控制項加入至 Office 文件。

您無法在您的程式碼中建立這個介面的執行個體，因為它沒有任何公用建構函式。 若要在文件層級專案中取得這個介面的執行個體，請在專案中使用其中一個 Sheetn 類別的 Controls 屬性。 若要在文件層級專案中取得這個介面的執行個體，請使用您在執行階段以程式設計方式取得的 Worksheet 主項目其 Controls 屬性。 如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。

下表顯示如何使用 ControlCollection 成員，執行一些與文件上之控制項相關的一般工作。

工作	動作
將控制項加入至工作表。	使用其中一種 Add<control> 方法。 比方說，要加入 Microsoft.Office.Tools.Excel.ListObject，請使用 AddListObject 方法。
從工作表移除控制項。	請使用 Remove 方法。
判斷控制項是否在集合中。	將控制項或其名稱傳送給 Contains 方法。
取得集合中控制項的索引。	將控制項或其名稱傳送給 IndexOf 方法。
從集合取得控制項。	將索引或控制項的名稱傳遞至 Item 屬性。

注意事項
此介面是由 Visual Studio Tools for Office Runtime 所實作， 並不能實作於您的程式碼中。 如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用方式

本文件說明此型別用於以 .NET Framework 4 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。 如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

請參閱

參考

Microsoft.Office.Tools.Excel 命名空間