Практическое руководство. Сопоставление столбцов элемента управления ListObject данным

Обновлен: Ноябрь 2007

Применение
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Проекты уровня документа Excel 2007 Excel 2003 Проекты уровня приложения Excel 2007 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

При привязке элемента управления ListObject к элементу управления DataTable может потребоваться скрыть часть столбцов в списке, либо оставить часть столбцов без привязки к данным. Указать, какие столбцы будут отображаться в элементе управления ListObject, можно при вызове метода SetDataBinding.

Сопоставление столбцов

Сопоставление таблицы данных столбцам в списке

1. Создайте на уровне класса объект DataTable.

   Dim table As System.Data.DataTable = New System.Data.DataTable("Employees")
   

   System.Data.DataTable table = new System.Data.DataTable("Employees");
   

2. Добавьте столбцы образцов в обработчик событий Startup класса Sheet1 (для проекта уровня документа) или класса ThisAddIn (для проекта уровня приложения).

   table.Columns.Add("Id", GetType(Int32))
   table.Columns.Add("FirstName", GetType(String))
   table.Columns.Add("LastName", GetType(String))
   table.Columns.Add("Title", GetType(String))
   
   table.Rows.Add(1, "Nancy", "Anderson", "Sales Representative")
   table.Rows.Add(2, "Robert", "Brown", "Sales Representative")
   

   table.Columns.Add("Id", typeof(int));
   table.Columns.Add("FirstName", typeof(string));
   table.Columns.Add("LastName", typeof(string));
   table.Columns.Add("Title", typeof(string));
   
   table.Rows.Add(1, "Nancy", "Anderson", "Sales Representative");
   table.Rows.Add(2, "Robert", "Brown", "Sales Representative");
   

3. Вызовите метод SetDataBinding и передайте в качестве параметров имена столбцов в порядке их отображения. Объект списка будет привязан к вновь созданному объекту DataTable, однако порядок столбцов в объекте списка будет отличаться от порядка их отображения в объекте DataTable.

   Me.List1.AutoSetDataBoundColumnHeaders = True
   Me.List1.SetDataBinding(table, "", "Title", "LastName", "FirstName")
   

   this.list1.AutoSetDataBoundColumnHeaders = true;
   this.list1.SetDataBinding(table, "", "Title", "LastName", "FirstName");
   

Указание несопоставленных столбцов

При сопоставлении столбцов объекту DataTable также можно указать, чтобы определенные столбцы не были привязаны к данным, передав пустую строку. После этого в элемент управления ListObject добавляется новый столбец, не привязанный к данным.

Указание несопоставленного столбца при сопоставлении столбцов элемента управления ListObject

• Вызовите метод SetDataBinding и передайте в качестве параметров имена столбцов в порядке их отображения. Чтобы указать место, в которое добавляется несопоставленный столбец, используйте пустую строку; в данном случае этот столбец расположен между столбцом должности и столбцом фамилии.

  Me.List1.SetDataBinding(table, "", "Title", "", "LastName", "FirstName")
  

  this.list1.SetDataBinding(table, "", "Title", "", "LastName", "FirstName");
  

Компиляция кода

В данном примере кода предполагается, что на листе, к которому применяется этот код, имеется элемент управления ListObject с именем list1.

См. также

Задачи

Практическое руководство. Заполнение данными элементов управления ListObject

Основные понятия

Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения

Разработка надстроек уровня приложения для Excel

Добавление элементов управления в документы Office во время выполнения

Элемент управления ListObject

Основные сведения о сохранении порядка столбцов и строк ListObject.

Другие ресурсы

Элементы управления в документах Office

Элементы управления ведущего приложения Excel