Share via

WorksheetBase - класс

  • Статья

Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel.

Иерархия наследования

System.Object
  Microsoft.Office.Tools.Excel.WorksheetBase

Пространство имен:  Microsoft.Office.Tools.Excel
Сборка:  Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Синтаксис

'Декларация
Public MustInherit Class WorksheetBase _
    Implements IWorksheetExtension, IExtension, EntryPoint, ISupportInitialize,  _
    IBindableComponent, IComponent, IDisposable

public abstract class WorksheetBase : IWorksheetExtension, 
    IExtension, EntryPoint, ISupportInitialize, IBindableComponent, IComponent, 
    IDisposable

Тип WorksheetBase предоставляет следующие члены.

Конструкторы

  Имя Описание
Защищенный метод WorksheetBase Инфраструктура.

В начало страницы

Свойства

  Имя Описание
Открытое свойство _CodeName Инфраструктура.
Открытое свойство _DisplayRightToLeft Инфраструктура.
Открытое свойство Application Получает объект Microsoft.Office.Interop.Excel.Application, представляющий приложение Microsoft Office Excel.
Открытое свойство AutoFilter Получает объект Microsoft.Office.Interop.Excel.AutoFilter, предоставляющий информацию об отфильтрованных списках на листе, если фильтрация включена.Получает значение nullпустая ссылка (Nothing в Visual Basic), если фильтрация выключена.
Открытое свойство AutoFilterMode Получает или задает значение, указывающее, включена ли фильтрация на листе в настоящий момент (т. е. указывает, отображаются ли стрелки раскрывающихся списков фильтрации в настоящий момент).
Открытое свойство Base Получает или задает объект Worksheet, расширяемый данным объектом WorksheetBase.
Открытое свойство BindingContext Инфраструктура.
Открытое свойство Cells Возвращает объект Range, представляющий все ячейки рабочего листа (а не только используемые в данный момент ячейки).
Открытое свойство CircularReference Возвращает объект Range, представляющий диапазон, который содержит первую циклическую ссылку на рабочем листе, либо возвращает nullпустая ссылка (Nothing в Visual Basic), если на рабочем листе нет циклических ссылок.
Открытое свойство CodeName Инфраструктура.
Открытое свойство Columns Получает объект Range, представляющий один или несколько столбцов на листе.
Открытое свойство Comments Возвращает коллекцию Microsoft.Office.Interop.Excel.Comments, представляющую все комментарии для рабочего листа.
Открытое свойство ConsolidationFunction Возвращает код функции для текущей консолидации.
Открытое свойство ConsolidationOptions Возвращает массив Array параметров консолидации, состоящий из трех элементов.
Открытое свойство ConsolidationSources Возвращает строковый массив Array с именами исходных листов и диапазонов для текущей консолидации рабочего листа.
Открытое свойство Controls Получает коллекцию управляемых элементов управления, содержащихся на листе.
Открытое свойство Creator Возвращает значение, указывающее на приложение, в котором был создан рабочий лист.
Открытое свойство CustomProperties Возвращает объект Microsoft.Office.Interop.Excel.CustomProperties, представляющий сведения идентификатора, связанного с рабочим листом.
Открытое свойство DataBindings Инфраструктура.
Открытое свойство DataHost Инфраструктура.
Открытое свойство DisplayAutomaticPageBreaks Инфраструктура.
Открытое свойство DisplayPageBreaks Возвращает или задает значение, определяющее отображение на рабочем листе разрывов страниц (установленных вручную или автоматически).
Открытое свойство DisplayRightToLeft Возвращает или задает значение, указывающее, должен ли рабочий лист отображаться справа налево, а не слева направо.
Открытое свойство EnableAutoFilter Возвращает или задает значение, определяющее отображение стрелок автофильтрации при использовании защиты только пользовательского интерфейса.
Открытое свойство EnableCalculation Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel производить автоматический перерасчет рабочего листа при необходимости.
Открытое свойство EnableFormatConditionsCalculation Возвращает или задает значение, указывающее на использование автоматической оценки условных форматов.
Открытое свойство EnableOutlining Возвращает или задает значение, определяющее отображение символов структуры при использовании защиты только пользовательского интерфейса.
Открытое свойство EnablePivotTable Возвращает или задает значение, определяющее возможность использования элементов управления и функций сводных таблиц при применении защиты только пользовательского интерфейса.
Открытое свойство EnableSelection Возвращает или задает значение, определяющее ячейки на листе, которые могут быть выделены.
Открытое свойство FilterMode Получает значение, указывающее, выполняется ли на листе активная фильтрация данных.
Открытое свойство HostContext Инфраструктура.
Открытое свойство HPageBreaks Возвращает коллекцию Microsoft.Office.Interop.Excel.HPageBreaks, представляющую горизонтальные разрывы страницы на листе.
Открытое свойство Hyperlinks Возвращает коллекцию Microsoft.Office.Interop.Excel.Hyperlinks, представляющую гиперссылки на диапазон или лист.
Открытое свойство Index Возвращает номер индекса рабочего листа в пределах коллекции рабочих листов.
Открытое свойство InnerObject Получает объект Microsoft.Office.Interop.Excel.Worksheet, представляющий собственный базовый объект для объекта WorksheetBase.
Открытое свойство ItemProvider Инфраструктура.
Открытое свойство ListObjects Возвращает коллекцию объектов Microsoft.Office.Interop.Excel.ListObject на рабочем листе.
Открытое свойство MailEnvelope Возвращает заголовок электронного сообщения для рабочего листа.
Открытое свойство Name Возвращает или задает имя рабочего листа.
Открытое свойство Names Получает коллекцию Microsoft.Office.Interop.Excel.Names, представляющую все имена, характерные для листа (имена, определенные с префиксом "WorksheetName!").
Открытое свойство Next Возвращает объект Microsoft.Office.Interop.Excel.Worksheet, представляющий следующий лист.
Открытое свойство OnCalculate Инфраструктура.
Открытое свойство OnData Инфраструктура.
Открытое свойство OnDoubleClick Инфраструктура.
Открытое свойство OnEntry Инфраструктура.
Открытое свойство OnSheetActivate Инфраструктура.
Открытое свойство OnSheetDeactivate Инфраструктура.
Открытое свойство Outline Возвращает объект Microsoft.Office.Interop.Excel.Outline, представляющий структуру рабочего листа.
Открытое свойство PageSetup Возвращает объект Microsoft.Office.Interop.Excel.PageSetup, содержащий все параметры настройки страницы для рабочего листа.
Открытое свойство Parent Возвращает родительский объект рабочего листа.
Открытое свойство Previous Возвращает объект Microsoft.Office.Interop.Excel.Worksheet, представляющий предыдущий лист.
Открытое свойство PrintedCommentPages Получает число страниц примечаний, которые будут печататься для текущего листа.Это свойство можно использовать только в проектах Excel 2010.
Открытое свойство ProtectContents Возвращает значение, которое указывает на наличие защиты содержимого рабочего листа (отдельных ячеек).
Открытое свойство ProtectDrawingObjects Возвращает значение, которое указывает на наличие защиты фигур в объекте.
Открытое свойство Protection Возвращает объект Microsoft.Office.Interop.Excel.Protection, представляющий параметры защиты рабочего листа.
Открытое свойство ProtectionMode Возвращает значение, указывающее на использование защиты "только пользовательский интерфейс".
Открытое свойство ProtectScenarios Возвращает значение, которое указывает на наличие защиты скриптов рабочего листа.
Открытое свойство QueryTables Возвращает коллекцию Microsoft.Office.Interop.Excel.QueryTables, представляющую все таблицы запросов на рабочем листе.
Открытое свойство Range Возвращает объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.
Открытое свойство Rows Получает объект Range, представляющий одну или несколько строк на листе.
Открытое свойство Scripts Возвращает коллекцию Microsoft.Office.Core.Scripts, содержащую объекты Script, которые представляют блоки скрипта или кода в рабочем листе при его сохранении в форме веб-страницы.
Открытое свойство ScrollArea Возвращает или задает диапазон, в котором разрешена прокрутка, в виде ссылки на диапазон в формате A1.
Открытое свойство Shapes Возвращает объект Microsoft.Office.Interop.Excel.Shapes, представляющий все фигуры на рабочем листе.
Открытое свойство Site Инфраструктура.
Открытое свойство SmartTags Возвращает объект Microsoft.Office.Interop.Excel.SmartTags, представляющий коллекцию смарт-тегов рабочего листа.
Открытое свойство Sort Возвращает отсортированные значения в текущем рабочем листе.
Открытое свойство StandardHeight Возвращает стандартную высоту (по умолчанию) в пунктах всех строк на рабочем листе.
Открытое свойство StandardWidth Возвращает или задает стандартную ширину (по умолчанию) всех столбцов на рабочем листе.
Открытое свойство Tab Возвращает Microsoft.Office.Interop.Excel.Tab для рабочего листа.
Открытое свойство Tag Возвращает или задает объект, который содержит данные о рабочем листе.
Открытое свойство TransitionExpEval Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel использовать для рабочего листа правила вычисления выражений Lotus 1-2-3.
Открытое свойство TransitionFormEntry Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel использовать для рабочего листа правила ввода формул Lotus 1-2-3.
Открытое свойство Type Возвращает тип рабочего листа.
Открытое свойство UsedRange Возвращает объект Microsoft.Office.Interop.Excel.Range, который представляет все ячейки, содержащие значение на данный момент.
Открытое свойство Visible Возвращает или задает значение Microsoft.Office.Interop.Excel.XlSheetVisibility, указывающее на то, является ли объект видимым.
Открытое свойство VPageBreaks Возвращает коллекцию Microsoft.Office.Interop.Excel.VPageBreaks, представляющую вертикальные разрывы страницы на листе.

В начало страницы

Методы

  Имя Описание
Открытый метод Activate Инфраструктура.
Открытый метод Arcs Инфраструктура.
Открытый метод BeginInit Инфраструктура.
Открытый метод Buttons Инфраструктура.
Открытый метод CalculateMethod Производит вычисление формул на рабочем листе.
Открытый метод ChartObjects Возвращает объект, представляющий либо отдельную внедренную диаграмму (объект Microsoft.Office.Interop.Excel.ChartObject), либо коллекцию всех внедренных диаграмм (коллекция Microsoft.Office.Interop.Excel.ChartObjects) на рабочем листе.
Открытый метод CheckBoxes Инфраструктура.
Открытый метод CheckSpelling Инфраструктура.
Открытый метод CircleInvalid Помечает кружками недопустимые значения на рабочем листе.
Открытый метод ClearArrows Удаляет с рабочего листа стрелки трассировки.Стрелки трассировки добавляются с помощью функции аудита.
Открытый метод ClearCircles Снимает кружки с недопустимых значений на рабочем листе.
Открытый метод Copy Копирует рабочий лист в другое местоположение в рабочей книге.
Открытый метод Delete Удаляет базовый объект Microsoft.Office.Interop.Excel.Worksheet, но не удаляет ведущий элемент.Настоятельно рекомендуется не использовать данный метод.
Открытый метод Dispose Освобождает все ресурсы, используемые текущим экземпляром класса WorksheetBase.
Открытый метод DrawingObjects Инфраструктура.
Открытый метод Drawings Инфраструктура.
Открытый метод DropDowns Инфраструктура.
Открытый метод EndInit Инфраструктура.
Открытый метод Equals Определяет, равен ли заданный объект Object текущему объекту Object. (Унаследовано от Object.)
Открытый метод Evaluate Преобразует имя Microsoft Office Excel в объект или значение.
Открытый метод ExportAsFixedFormat Экспортирует в файл указанного формата.
Защищенный метод Finalize Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
Защищенный метод FinishInitialization Инфраструктура.
Открытый метод get_Range Возвращает объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.Вместо этого метода можно использовать свойство Range.
Защищенный метод GetAutomationObject Вызывается Среда выполнения Visual Studio Tools for Office для получения объекта, который может использоваться кодом VBA в листе.
Открытый метод GetHashCode Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
Открытый метод GetType Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
Открытый метод GroupBoxes Инфраструктура.
Открытый метод GroupObjects Инфраструктура.
Защищенный метод Initialize Инфраструктура.
Защищенный метод InitializeDataBindings Инфраструктура.
Открытый метод Labels Инфраструктура.
Открытый метод Lines Инфраструктура.
Открытый метод ListBoxes Инфраструктура.
Защищенный метод MemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый метод Move Перемещает рабочий лист в другое местоположение в рабочей книге.
Открытый метод OLEObjects Возвращает объект, представляющий либо отдельный объект OLE (объект Microsoft.Office.Interop.Excel.OLEObject), либо коллекцию всех объектов OLE (коллекция Microsoft.Office.Interop.Excel.OLEObjects) на рабочем листе.
Защищенный метод OnShutdown Инфраструктура.
Защищенный метод OnStartup Инфраструктура.
Открытый метод OptionButtons Инфраструктура.
Открытый метод Ovals Инфраструктура.
Открытый метод Paste Вставляет в рабочий лист содержимое буфера обмена.
Открытый метод PasteSpecial Вставляет в рабочий лист содержимое буфера обмена с использованием указанного формата.Данный метод используется для вставки данных из других приложений или вставки данных в определенном формате.
Открытый метод Pictures Инфраструктура.
Открытый метод PivotTables Возвращает объект, представляющий либо отдельный отчет сводной таблицы (объект Microsoft.Office.Interop.Excel.PivotTable), либо коллекцию всех отчетов сводных таблиц (коллекция Microsoft.Office.Interop.Excel.PivotTables) на рабочем листе.
Открытый метод PivotTableWizard Создает объект Microsoft.Office.Interop.Excel.PivotTable.
Открытый метод PrintOut Печать рабочего листа.
Открытый метод PrintOutEx Печать рабочего листа.
Открытый метод PrintPreview Представляет предварительный просмотр рабочего листа, как он бы выглядел при печати.
Открытый метод Protect Защищает рабочий лист от изменений.
Открытый метод Rectangles Инфраструктура.
Открытый метод ResetAllPageBreaks Сброс всех разрывов страницы на указанном рабочем листе.
Открытый метод SaveAs Сохраняет изменения в рабочем листе в другой файл.
Открытый метод Scenarios Возвращает объект, представляющий либо отдельный скрипт (объект Microsoft.Office.Interop.Excel.Scenario), либо коллекцию скриптов (коллекция Microsoft.Office.Interop.Excel.Scenarios) на рабочем листе.
Открытый метод ScrollBars Инфраструктура.
Открытый метод Select Выделение рабочего листа.
Открытый метод SetBackgroundPicture Задает фоновое изображение для рабочего листа.
Открытый метод ShowAllData Делает все строки фильтруемого списка видимыми.Если используется автофильтрация, вызов данного метода приводит к изменению стрелок на стрелки "Все".
Открытый метод ShowDataForm Отображение формы данных, связанной с рабочим листом.
Открытый метод Spinners Инфраструктура.
Открытый метод TextBoxes Инфраструктура.
Открытый метод ToString Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)
Открытый метод Unprotect Снимает защиту с рабочего листа.Если на рабочем листе нет защиты, этот метод не работает.
Открытый метод XmlDataQuery Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath.Возвращает nullпустая ссылка (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом, или если сопоставленный диапазон пуст.
Открытый метод XmlMapQuery Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath.Возвращает nullпустая ссылка (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом.

В начало страницы

События

  Имя Описание
Открытое событие ActivateEvent Происходит при активации рабочего листа.
Открытое событие BeforeDoubleClick Происходит при двойном щелчке по листу перед вызовом обработчика двойного щелчка по умолчанию.
Открытое событие BeforeRightClick Происходит при щелчке правой кнопкой мыши любого листа перед вызовом обработчика щелчка правой кнопкой мыши по умолчанию.
Открытое событие BindingContextChanged Инфраструктура.
Открытое событие Calculate Происходит после пересчета рабочего листа.
Открытое событие Change Происходит, когда в ячейки WorksheetBase вносятся какие-либо изменения.
Открытое событие Deactivate Происходит при потере фокуса рабочим листом.
Открытое событие Disposed Инфраструктура.
Открытое событие FollowHyperlink Происходит при переходе по любой гиперссылке на листе.
Открытое событие PivotTableAfterValueChange Происходит после изменения или пересчета ячейки либо диапазона ячеек в сводной таблице (для ячеек, содержащих формулы).Это событие можно использовать только в проектах Excel 2010.
Открытое событие PivotTableBeforeAllocateChanges Происходит перед применением изменений к сводной таблице.Это событие можно использовать только в проектах Excel 2010.
Открытое событие PivotTableBeforeCommitChanges Происходит перед внесением изменений в источник данных OLAP для сводной таблицы.Это событие можно использовать только в проектах Excel 2010.
Открытое событие PivotTableBeforeDiscardChanges Происходит перед отменой изменений в сводной таблице.Это событие можно использовать только в проектах Excel 2010.
Открытое событие PivotTableChangeSync Происходит после изменений в сводной таблице.Это событие можно использовать только в проектах Excel 2010.
Открытое событие PivotTableUpdate Происходит при обновлении отчета сводной таблицы на рабочем листе.
Открытое событие SelectionChange Происходит при изменении выделения на листе.
Открытое событие Shutdown Происходит при закрытии ведущего элемента листа.
Открытое событие Startup Инфраструктура.

В начало страницы

Явные реализации интерфейса

  Имя Описание
Явная реализация интерфейсаЗакрытый метод EntryPoint.BeginInit Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.EndInit Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.FinishInitialization Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.Initialize Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.InitializeDataBindings Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.OnShutdown Инфраструктура.
Явная реализация интерфейсаЗакрытый метод EntryPoint.OnStartup Инфраструктура.
Явная реализация интерфейсаЗакрытое свойство IExtension.ExtensionBase Инфраструктура.
Явная реализация интерфейсаЗакрытый метод IWorksheetExtension.GetAutomationObject Инфраструктура.

В начало страницы

Заметки

Класс WorksheetBase является базовым классом для классов Sheetn в проектах уровня документа Excel, созданных с помощью Visual Studio. Классы Sheetn используются для программного доступа к листам в проекте. Класс WorksheetBase — ведущий элемент, представляющий лист в проектах уровня документа. Дополнительные сведения см. в разделах Общие сведения о ведущих элементах и элементах управления ведущего приложения и Ведущие элементы листа.

Класс WorksheetBase предоставляет те же члены, что и класс Microsoft.Office.Interop.Excel.Worksheet в основной сборке взаимодействия Excel, а также следующие дополнительные возможности:

  • Свойство Controls. Это свойство используется для добавления управляемых элементов управления на лист Excel или удаления элементы управления, во время выполнения.

  • Свойство InnerObject. Используйте это свойство для получения базового объекта Microsoft.Office.Interop.Excel.Worksheet для ведущего элемента книги.

  • GetAutomationObject. Переопределите этот метод, чтобы предоставить класс из вашего проекта коду VBA в листе.

  • События уровня документа, например ActivateEvent и Change, представленные в объектной модели Excel только на уровне приложения. Таким образом, в объектной модели Excel эти события определены в классе Microsoft.Office.Interop.Excel.Application, а не в классе Microsoft.Office.Interop.Excel.Worksheet.

Создание ведущих элементов листов

Объекты WorksheetBase не удастся создать программно в проектах Office.

В проектах уровня документа экземпляры классов Sheetn (которые являются производными от WorksheetBase) создаются автоматически средой Среда выполнения Visual Studio Tools for Office, когда конечный пользователь открывает книгу. Дополнительные сведения см. в разделе Настройки программирования уровня документа.

В проектах уровня приложения можно создавать ведущие элементы листа программным путем с помощью метода GetVstoObject. Ведущего элемента листа, который создается, является объектом Microsoft.Office.Tools.Excel.Worksheet, а не WorksheetBase. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.

Использование

Данный тип используется только в проектах Office, предназначенных для платформы .NET Framework 4. Определяющая этот тип сборка не входит в состав среды выполнения Visual Studio Tools for Office. Необходимо развернуть эту сборку вместе с решением. Дополнительные сведения см. в разделе Сборки среды выполнения Visual Studio Tools for Office.

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

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

Worksheet Host Item

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

Общие сведения о ведущих элементах и элементах управления ведущего приложения