Пошаговое руководство. Привязка данных к элементам управления в панели действий Excel

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

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

В этом пошаговом руководстве демонстрируется привязка данных к элементам управления в панели действий Microsoft Office Excel. Элементы управления отражают "основную/подробную" взаимосвязь между таблицами в базе данных SQL Server.

В данном пошаговом руководстве демонстрируются следующие задачи:

• Добавление элементов управления на лист.

• Создание элемента управления панели действий.

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

• Отображение панели действий при открытии приложения.

Примечание.
На компьютере могут отображаться имена или расположения некоторых элементов пользовательского интерфейса Visual Studio, отличающиеся от указанных в дальнейших инструкциях. Эти элементы определяются используемой версией Visual Studio и ее параметрами. Дополнительные сведения см. в разделе Параметры Visual Studio.

Обязательные компоненты

Для выполнения инструкций данного пошагового руководства необходимы следующие компоненты:

• Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System).

• Microsoft Office Excel 2003 или Microsoft Office Excel 2007. В данном руководстве в примерах используются меню Excel 2003.

• Доступ к серверу SQL Server с учебной базой данных "Northwind".

• разрешения на чтение из базы данных SQL Server и запись в нее.

Visual Studio Tools for Office устанавливается по умолчанию с перечисленными версиями Visual Studio. Чтобы проверить, установлен ли данный набор средств, см. раздел Установка средств Visual Studio для Office.

Создание проекта

На первом этапе необходимо создать проект книги Excel.

Чтобы создать новый проект, выполните следующие действия.

• Создайте проект книги Excel с именем Моя панель действий Excel. Выберите в мастере Создать новый документ. Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Visual Studio Tools for Office.

  Созданная книга Excel открывается в конструкторе Visual Studio. Проект Моя панель действий Excel добавляется в Обозреватель решений.

Добавление в проект нового источника данных

Добавление в проект нового источника данных

1. Если окно Источники данных не отображается, в меню Данные выберите пункт Показать источники данных.

   Примечание.
   Если команда Показать источники данных недоступна, нажмите кнопку мыши внутри листа Excel и попробуйте снова.

2. Нажмите кнопку Добавить новый источник данных, чтобы запустить Мастер настройки источника данных.

3. Выберите База данных и нажмите Далее.

4. Выберите подключение к базе данных SQL Server "Northwind" или добавьте новое подключение с помощью кнопки Новое подключение.

5. Нажмите кнопку Далее.

6. Чтобы сохранить подключение, снимите флажок (если он установлен) и нажмите кнопку Далее.

7. В окне Объекты базы данных разверните узел Таблицы.

8. Установите флажок рядом с таблицей Поставщики.

9. Раскройте таблицу Продукты и выберите ProductName, SupplierID, QuantityPerUnit и UnitPrice.

10. Нажмите кнопку Готово.

Мастер добавит таблицы Поставщики и Продукты в окно Источники данных. Также к проекту добавляется типизированный набор данных, который отображается в Обозревателе решений.

Добавление элементов управления на лист

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

Добавление на лист элемента управления NamedRange и ListObject

1. Убедитесь, что в конструкторе Visual Studio открыта книга Моя панель действий Excel.xls и отображается Sheet1.

2. Разверните таблицу Поставщики в окне Источники данных.

3. Щелкните стрелку вниз на узле Название компании и выберите пункт NamedRange.

4. Перетащите узел Имя компании из окна Источников данных в ячейку A2 на листе Sheet1.

   Создается элемент управления NamedRange с именем CompanyNameNamedRange и в ячейке A2 появляется текст <CompanyName>. Одновременно в проект добавляются элемент управления BindingSource с именем suppliersBindingSource, адаптер таблиц и экземпляр класса DataSet. Элемент управления связан с объектом BindingSource, который, в свою очередь, связан с экземпляром DataSet.

5. В окне Источники данных перейдите к столбцам под таблицей Поставщики. В нижней части списка располагается таблица Продукты, которая является дочерней по отношению к таблице Поставщики. Выберите дочернюю таблицу Продукты (не расположенную на одном уровне с таблицей Поставщики) и щелкните появившуюся стрелку раскрывающегося списка.

6. Выберите в раскрывающемся списке элемент управления ListObject и перетащите таблицу Продукты в ячейку A6 листа Sheet1.

   В ячейке А6 будет создан элемент управления ListObject с именем ProductNameListObject. Одновременно в проект добавляется элемент управления BindingSource с именем productsBindingSource и адаптер таблиц. Элемент управления связан с объектом BindingSource, который, в свою очередь, связан с экземпляром DataSet.

7. Только для C#. Выберите suppliersBindingSource в области компонентов и измените значение свойства Modifiers на Internal в окне Свойства.

Добавление элементов управления на панель действий

После этого требуется элемент управления панели действий, содержащий поле со списком.

Добавление элемента управления панели действий

1. Выберите проект Моя панель действий Excel в Обозревателе решений.

2. В меню Проект выберите команду Добавить новый элемент.

3. В диалоговом окне Добавление нового элемента выберите Элемент управления панели действий, дайте файлу имя ActionsControl и нажмите кнопку Добавить.

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

1. Перетащите со вкладки Стандартные элементы управления в панели элементов элемент управления ComboBox на элемент управления панели действий.

2. Измените значение свойства Size на 171, 21.

3. Измените размер пользовательского элемента управления в соответствии с размерами поля со списком.

Привязка элемента управления панели действий к данным

В этом разделе источник данных элемента управления ComboBox задается таким же, как у элемента управления NamedRange на листе.

Установка свойств привязки данных элемента управления

1. Щелкните файл правой кнопкой мыши элемент управления панели действий и выберите команду Просмотреть код.

2. Добавьте следующий код в событие Load элемента управления панели действий.

   Private Sub ActionsControl_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles Me.Load
   
       Me.ComboBox1.DataSource = Globals.Sheet1.SuppliersBindingSource
       Me.ComboBox1.DisplayMember = "CompanyName"
   End Sub
   

   private void ActionsControl_Load(object sender, EventArgs e)
   {
       this.comboBox1.DataSource = Globals.Sheet1.suppliersBindingSource;
       this.comboBox1.DisplayMember = "CompanyName";
   }
   

3. В C# следует создать обработчик событий для события ActionsControl. Можно заменить этот код в конструкторе ActionsControl. Сведения о создании обработчиков событий см. в разделе Практическое руководство. Создание обработчиков событий в пакете инструментов Visual Studio для Office.

   public ActionsControl()
   {
       InitializeComponent();
       this.Load += new EventHandler(ActionsControl_Load);
   }
   

Отображение панели действий

Панель действий не видима, пока элемент управления не будет добавлен во время выполнения.

Отображение панели действий

1. В Обозревателе решений щелкните правой клавишей мыши файл ThisWorkbook.cs или ThisWorkbook.vb, а затем выберите команду Просмотреть код.

2. Создайте новый экземпляр пользовательского элемента управления в классе ThisWorkbook.

   Dim actions As New ActionsControl
   

   ActionsControl actions = new ActionsControl();
   

3. В обработчик Startup событий ThisWorkbook добавьте элемент управления в панель действий.

   Private Sub ThisWorkbook_Startup(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Startup
   
       Me.ActionsPane.Controls.Add(actions)
   End Sub
   

   private void ThisWorkbook_Startup(object sender, System.EventArgs e)
   {
       this.ActionsPane.Controls.Add(actions);
   }
   

Чтобы проверить работу приложения

Теперь можно протестировать документ, чтобы проверить, что при его открытии открывается панель действий и что у элементов управления есть отношение "основной/подробности".

Проверка документа

1. Нажмите клавишу F5 для запуска проекта.

2. Убедитесь, что панель действий отображается.

3. Выберите компанию из списка. Убедитесь, что сведения о компании перечислены в элементе управления NamedRange и что описание продукта перечислены в элементе управления ListObject.

4. Выберите разные компании, чтобы убедиться, что имя компании и описание продукта изменяются соответствующим образом.

Следующие действия

Вот некоторые задачи, которые могут возникать впоследствии:

• Развертывание проекта. Дополнительные сведения см. в разделе Практическое руководство. Развертывание решений Office (система 2003).

• Привязка данных к элементам управления в Word. Дополнительные сведения см. в разделе Пошаговое руководство. Привязка данных к элементам управления в панели действий Word.

• Отображение и скрытие элементов управления в панели действий. Дополнительные сведения см. в разделе Пошаговое руководство. Изменение панели действий в зависимости от контекста пользователя.

См. также

Задачи

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

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

Общие сведения о панели действий

Привязка данных к элементам управления