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


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

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

Применение

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

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

Версия Microsoft Office

  • Excel 2003

  • Excel 2007

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

При привязке данных к элементу управления ListObject, добавленному к документу во время разработки, Visual Studio Tools for Office отслеживает столбец и строку при каждом сохранении книги. Если пользователь перемещает столбцы или строки объекта ListObject во время выполнения, то новый порядок сохраняется при следующем открытии книги, а элемент управления ListObject повторно выполняет привязку к источнику данных.

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

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

Имя свойства определяется с помощью хэш-кода для комбинации имени листа и объекта листа. Например, имя пользовательского свойства документа для элемента управления ListObject с именем List1 в Sheet1 будет выглядеть как "___2387CEF09___0". Если значение этого свойства превышает 255 символов в длину, то создается другое пользовательское свойство документа, к которому добавляется порядковый номер; например, "___2387CEF09___1", "___2387CEF09___2" и т. д.

Значение пользовательского свойства документа содержит имена столбцов и номера строк. Например, если объект ListObject состоит из четырех строк и двух столбцов с именем LastName и FirstName, то значение свойства будет равным "FirstName*LastName%1*2*3*4". Если пользователь переместит третью строку выше второй строки, то при сохранении книги значение будет изменено на "FirstName*LastName%1*3*2*4".

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

Восстановление порядка столбцов и строк

Чтобы восстановить для ListObject исходный порядок столбцов и строк, необходимо вызвать метод ResetPersistedBindingInformation. Этот метод удаляет пользовательские свойства документа, связанные с порядком столбцов и строк указанного объекта ListObject. Вызовите этот метод из события книги Shutdown, если сохранение порядка столбцов и строк ListObject не требуется.

См. также

Задачи

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

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

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

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

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