Поделиться через


ControlExtensions.AddDataGridView - метод (ControlCollection, Double, Double, Double, Double, 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, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As DataGridView
public static DataGridView AddDataGridView(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

Параметры

  • controls
    Тип: Microsoft.Office.Tools.Excel.ControlCollection
    Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Worksheet.Controls (в проекте уровня приложения) или свойством WorksheetBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
  • left
    Тип: System.Double
    Расстояние в пунктах между левым краем элемента управления и левым краем листа.
  • top
    Тип: System.Double
    Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.
  • width
    Тип: System.Double
    Ширина элемента управления в пунктах.
  • height
    Тип: System.Double
    Высота элемента управления в пунктах.
  • name
    Тип: System.String
    Имя элемента управления.

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

Тип: Microsoft.Office.Tools.Excel.Controls.DataGridView
Элемент управления DataGridView, добавленный в экземпляр ControlCollection.

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ControlCollection. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

Исключения

Исключение Условие
ArgumentNullException

Аргумент имени равен nullпустая ссылка (Nothing в Visual Basic) или имеет нулевую длину.

ControlNameAlreadyExistsException

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

Заметки

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

Примеры

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

    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

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

Безопасность платформы .NET Framework

См. также

Ссылки

ControlExtensions Класс

AddDataGridView - перегрузка

Microsoft.Office.Tools.Excel - пространство имен