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
مجموعة لإضافة عنصر تحكم إلى.لا تقم بإدخال هذه معلمة نفسك.عندما تقوم باستدعاء th هو الأسلوب في المجموعة التي تم إرجاعها بواسطة Worksheet.Controlsخاصية (في مشروع المستوى تطبيق) أو WorksheetBase.Controlsخاصية (في مشروع المستوى المستندات)، رقم هو معلمة هو الذي تم توفيره بشكل تلقائي.
- range
النوع: Microsoft.Office.Interop.Excel.Range
Rangeوالتي توفر للحدود عنصر تحكم.
- name
النوع: System.String
اسم عنصر التحكم الذي يمكن أن تستخدم لفهرسة عنصر التحكم في ControlCollectionمثيل.
القيمة المُرجعة
النوع: Microsoft.Office.Tools.Excel.Controls.DataGridView
DataGridViewعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.
ملاحظة على الاستخدام
في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).
استثناءات
| استثناء: | شرط |
|---|---|
| ArgumentNullException | وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية. |
| ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
| InvalidRangeException | النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك 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.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.