ControlExtensions.AddDataGridView 方法 (ControlCollection, Range, String)
將新的 DataGridView 控制項加入至工作表中指定的範圍。
命名空間： Microsoft.Office.Tools.Excel
組件： Microsoft.Office.Tools.Excel.v4.0.Utilities (在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中)
語法
'宣告
<ExtensionAttribute> _
Public Shared Function AddDataGridView ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As DataGridView
public static DataGridView AddDataGridView(
this ControlCollection controls,
Range range,
string name
)
參數
- controls
型別：Microsoft.Office.Tools.Excel.ControlCollection
要加入控制項的集合。請勿自行提供此參數。當您在 Worksheet.Controls 屬性 (在應用程式層級的專案中) 或 WorksheetBase.Controls 屬性 (在文件層級的專案中) 所傳回的集合上呼叫這個方法時，會自動提供這個參數。
- range
型別：Microsoft.Office.Interop.Excel.Range
提供控制項繫結的 Range。
- name
型別：System.String
可於 ControlCollection 執行個體中用於索引控制項的控制項名稱。
傳回值
型別：Microsoft.Office.Tools.Excel.Controls.DataGridView
加入 ControlCollection 執行個體的 DataGridView 控制項中。
使用注意事項
在 Visual Basic 和 C# 中，您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時，請省略第一個參數。如需詳細資訊，請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | 名稱或範圍引數為 nullNull 參照 (即 Visual Basic 中的 Nothing)，或者名稱引數的長度為 0。 |
| ControlNameAlreadyExistsException | 具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。 |
| InvalidRangeException | 指定的範圍無效。 無法使用多區域範圍。 範圍必須放在和 ControlCollection 執行個體相同的工作表上。 |
備註
AddDataGridView 方法可以用來將 DataGridView 物件加入至 ControlCollection 的結尾。 若要移除先前以程式設計方式加入的 DataGridView，請使用 Remove 方法。
控制項會在重新調整範圍大小時自動重新調整大小。
範例
下列程式碼範例會將 DataGridView 控制項加入至儲存格 A1 至 D9，然後將兩個資料行加入至控制項。 若要使用這個範例，請在文件層級專案中的 Sheet1 類別執行。
Private Sub ExcelRangeAddDataGridView()
Dim DataGridView1 As Microsoft.Office.Tools.Excel. _
Controls.DataGridView = Me.Controls. _
AddDataGridView(Me.Range("A1", "D9"), _
"DataGridView1")
DataGridView1.Columns.Add("firsName", "First Name")
DataGridView1.Columns.Add("lastName", "Last Name")
End Sub
private void ExcelRangeAddDataGridView()
{
Microsoft.Office.Tools.Excel.Controls.DataGridView
dataGridView1 = this.Controls.AddDataGridView(
this.Range["A1", "D9"], "dataGridView1");
dataGridView1.Columns.Add("firsName", "First Name");
dataGridView1.Columns.Add("lastName", "Last Name");
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。