ControlExtensions.AddDataGridView Метод

Определение

Перегрузки

AddDataGridView(ControlCollection, Range, String)

Добавляет новый элемент управления DataGridView в указанный диапазон листа.

AddDataGridView(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления DataGridView указанного размера.

AddDataGridView(ControlCollection, Range, String)

Добавляет новый элемент управления DataGridView в указанный диапазон листа.

public static Microsoft.Office.Tools.Excel.Controls.DataGridView AddDataGridView (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

range
Range

Объект Range, предоставляющий границы элемента управления.

name
String

Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.

Возвращаемое значение

DataGridView

Элемент управления DataGridView, добавленный в экземпляр ControlCollection.

Исключения

Аргумент имени или диапазона равен null, или аргумент имени имеет нулевую длину.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Примеры

В следующем примере кода DataGridView элемент управления добавляется в ячейки с a1 по D9, а затем в элемент управления добавляются два столбца. Чтобы использовать этот пример, запустите его из Sheet1 класса в проекте уровня документа.

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");
}
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

Комментарии

AddDataGridViewМетод позволяет добавлять DataGridView объекты в конец ControlCollection . Чтобы удалить объект DataGridView , который был ранее добавлен программно, используйте Remove метод.

Размер элемента управления автоматически изменяется при изменении размера диапазона.

Применяется к

AddDataGridView(ControlCollection, Double, Double, Double, Double, String)

Добавляет в заданное место листа новый элемент управления DataGridView указанного размера.

public static Microsoft.Office.Tools.Excel.Controls.DataGridView AddDataGridView (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);

Параметры

controls
ControlCollection

Коллекция, в которую добавляется элемент управления. Не предоставляйте этот параметр вручную. При вызове этого метода для коллекции, возвращаемой свойством Controls (в проекте уровня приложения) или свойством Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

left
Double

Расстояние в пунктах между левым краем элемента управления и левым краем листа.

top
Double

Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.

width
Double

Ширина элемента управления в пунктах.

height
Double

Высота элемента управления в пунктах.

name
String

Имя элемента управления.

Возвращаемое значение

DataGridView

Элемент управления DataGridView, добавленный в экземпляр ControlCollection.

Исключения

Аргумент имени равен null или имеет нулевую длину.

Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.

Примеры

В следующем примере кода DataGridView элемент управления добавляется в верхнюю часть листа, а затем в элемент управления добавляются два столбца. Чтобы использовать этот пример, запустите его из Sheet1 класса в проекте уровня документа.

private void ExcelAddDataGridView()
{

    Microsoft.Office.Tools.Excel.Controls.DataGridView
        dataGridView1 = this.Controls.AddDataGridView(
        0, 0, 190, 112.5, "dataGridView1");
    dataGridView1.Columns.Add("firsName", "First Name");
    dataGridView1.Columns.Add("lastName", "Last Name");
}
Private Sub ExcelAddDataGridView()

    Dim DataGridView1 As Microsoft.Office.Tools.Excel. _
        Controls.DataGridView = Me.Controls. _
        AddDataGridView(0, 0, 190, 112.5, _
        "DataGridView1")
    DataGridView1.Columns.Add("firsName", "First Name")
    DataGridView1.Columns.Add("lastName", "Last Name")

End Sub

Комментарии

AddDataGridViewМетод позволяет добавлять DataGridView объекты в конец ControlCollection . Чтобы удалить DataGridView элемент управления, который был ранее добавлен программно, используйте Remove метод.

Применяется к