WorksheetBase Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel.
public ref class WorksheetBase abstract : IDisposable, Microsoft::Office::Tools::Excel::IWorksheetExtension, System::ComponentModel::IComponent, System::ComponentModel::ISupportInitialize, System::Windows::Forms::IBindableComponent[System.ComponentModel.ToolboxItem(false)]
public abstract class WorksheetBase : IDisposable, Microsoft.Office.Tools.Excel.IWorksheetExtension, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent[<System.ComponentModel.ToolboxItem(false)>]
type WorksheetBase = class
interface IWorksheetExtension
interface IExtension
interface EntryPoint
interface ISupportInitialize
interface IBindableComponent
interface IComponent
interface IDisposablePublic MustInherit Class WorksheetBase
Implements IBindableComponent, IComponent, IDisposable, ISupportInitialize, IWorksheetExtension- Наследование
-
WorksheetBase
- Атрибуты
- Реализации
Комментарии
Класс WorksheetBase является базовым классом для Sheetn классов в проектах Excel на уровне документа, созданных с помощью Visual Studio. Используйте классыSheet n для программного доступа к листам в проекте. Класс WorksheetBase является ведущим элементом , который представляет лист в проектах уровня документа. Дополнительные сведения см. в разделах Host Items and Host Controls Overview и Worksheet Host Item.
Класс 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.
В проектах Sheet уровня документа n классов (производных от WorksheetBase) автоматически создаются средой выполнения набор средств Visual Studio для Office, когда пользователь открывает книгу. Для получения дополнительной информации см. Programming Document-Level Customizations.
В проектах на уровне приложения можно создавать элементы узла листа программным способом с помощью GetVstoObject метода . Создаваемый Microsoft.Office.Tools.Excel.Worksheet ведущий элемент листа является объектом , а не WorksheetBase объектом . Дополнительные сведения см. в разделе Extending Word Documents and Excel Workbooks in VSTO Add-ins at Run Time.
Использование
Этот тип используется только в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. Сборка, в которой определяется этот тип, не входит в состав набора средств Visual Studio для Office (среда выполнения). Необходимо развернуть эту сборку вместе с решением. Дополнительные сведения см. в разделе Сборки в наборах средств Visual Studio для среды выполнения Office.
Конструкторы
| WorksheetBase(Factory, IServiceProvider, String, String) |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
Свойства
| Application |
Получает объект Application, представляющий приложение Microsoft Office Excel. |
| AutoFilter |
Получает объект AutoFilter, предоставляющий сведения об отфильтрованных списках на листе, если фильтрация включена. Получает объект |
| AutoFilterMode |
Получает или задает значение, указывающее, включена ли фильтрация на листе в настоящий момент (т. е. указывает, отображаются ли стрелки раскрывающихся списков фильтрации в настоящий момент). |
| Base |
Получает или задает объект Worksheet, расширяемый данным объектом WorksheetBase. |
| BindingContext |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Cells |
Возвращает объект Range, представляющий все ячейки рабочего листа (а не только используемые в данный момент ячейки). |
| CircularReference |
Возвращает объект Range, представляющий диапазон, который содержит первую циклическую ссылку на рабочем листе, либо возвращает |
| Columns |
Получает объект Range, представляющий один или несколько столбцов на листе. |
| Comments |
Возвращает коллекцию Comments, представляющую все комментарии для рабочего листа. |
| ConsolidationFunction |
Возвращает код функции для текущей консолидации. |
| ConsolidationOptions |
Возвращает массив Array параметров консолидации, состоящий из трех элементов. |
| ConsolidationSources |
Возвращает строковый массив Array с именами исходных листов и диапазонов для текущей консолидации рабочего листа. |
| Controls |
Получает коллекцию управляемых элементов управления, содержащихся на листе. |
| Creator |
Возвращает значение, указывающее на приложение, в котором был создан рабочий лист. |
| CustomProperties |
Возвращает объект CustomProperties, представляющий сведения идентификатора, связанного с рабочим листом. |
| DataBindings |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| DataHost |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| DisplayPageBreaks |
Возвращает или задает значение, определяющее отображение на рабочем листе разрывов страниц (установленных вручную или автоматически). |
| DisplayRightToLeft |
Возвращает или задает значение, указывающее, должен ли рабочий лист отображаться справа налево, а не слева направо. |
| EnableAutoFilter |
Возвращает или задает значение, определяющее отображение стрелок автофильтрации при использовании защиты только пользовательского интерфейса. |
| EnableCalculation |
Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel производить автоматический перерасчет рабочего листа при необходимости. |
| EnableFormatConditionsCalculation |
Возвращает или задает значение, указывающее на использование автоматической оценки условных форматов. |
| EnableOutlining |
Возвращает или задает значение, определяющее отображение символов структуры при использовании защиты только пользовательского интерфейса. Этот тип или член предназначен для использования только в проектах выпуска 2007 системы Microsoft Office. Смарт-теги упразднены в Office 2010. Этот тип или член предназначен для использования только в проектах выпуска 2007 системы Microsoft Office. Смарт-теги упразднены в Office 2010. |
| EnablePivotTable |
Возвращает или задает значение, определяющее возможность использования элементов управления и функций сводных таблиц при применении защиты только пользовательского интерфейса. |
| EnableSelection |
Возвращает или задает значение, определяющее ячейки на листе, которые могут быть выделены. |
| FilterMode |
Получает значение, указывающее, выполняется ли на листе активная фильтрация данных. |
| HostContext |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| HPageBreaks |
Возвращает коллекцию HPageBreaks, представляющую горизонтальные разрывы страницы на листе. |
| Hyperlinks |
Возвращает коллекцию Hyperlinks, представляющую гиперссылки на диапазон или рабочий лист. |
| Index |
Возвращает номер индекса рабочего листа в пределах коллекции рабочих листов. |
| InnerObject |
Получает объект Worksheet, представляющий базовый собственный объект WorksheetBase. |
| ItemProvider |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| ListObjects |
Возвращает коллекцию объектов ListObject на рабочем листе. |
| MailEnvelope |
Возвращает заголовок электронного сообщения для рабочего листа. |
| Name |
Возвращает или задает имя рабочего листа. |
| Names |
Возвращает коллекцию Names , представляющую все имена, относящиеся к листу (имена, определенные с префиксом WorksheetName!"). |
| Next |
Возвращает объект Worksheet, представляющий следующий лист. |
| Outline |
Возвращает объект Outline, представляющий структуру рабочего листа. |
| PageSetup |
Возвращает объект PageSetup, содержащий все параметры настройки страницы для рабочего листа. |
| Parent |
Возвращает родительский объект рабочего листа. |
| Previous |
Возвращает объект Worksheet, представляющий предыдущий лист. |
| PrintedCommentPages |
Получает число страниц примечаний, которые будут печататься для текущего листа. Это свойство можно использовать только в проектах Excel 2010. |
| ProtectContents |
Возвращает значение, которое указывает на наличие защиты содержимого рабочего листа (отдельных ячеек). |
| ProtectDrawingObjects |
Возвращает значение, которое указывает на наличие защиты фигур в объекте. |
| Protection |
Возвращает объект Protection, представляющий параметры защиты рабочего листа. |
| ProtectionMode |
Возвращает значение, указывающее на использование защиты "только пользовательский интерфейс". |
| ProtectScenarios |
Возвращает значение, которое указывает на наличие защиты скриптов рабочего листа. |
| QueryTables |
Возвращает коллекцию QueryTables, представляющую все таблицы запросов на рабочем листе. |
| Range |
Возвращает объект Range, представляющий ячейку или диапазон ячеек. |
| Rows |
Получает объект Range, представляющий одну или несколько строк на листе. |
| ScrollArea |
Возвращает или задает диапазон, в котором разрешена прокрутка, в виде ссылки на диапазон в формате A1. |
| Shapes |
Возвращает объект Shapes, представляющий все фигуры на рабочем листе. |
| Site |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Sort |
Возвращает отсортированные значения в текущем рабочем листе. |
| StandardHeight |
Возвращает стандартную высоту (по умолчанию) в пунктах всех строк на рабочем листе. |
| StandardWidth |
Возвращает или задает стандартную ширину (по умолчанию) всех столбцов на рабочем листе. |
| Tab |
Возвращает Tab для рабочего листа. |
| Tag |
Возвращает или задает объект, который содержит данные о рабочем листе. |
| TransitionExpEval |
Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel использовать для рабочего листа правила вычисления выражений Lotus 1-2-3. |
| TransitionFormEntry |
Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel использовать для рабочего листа правила ввода формул Lotus 1-2-3. |
| Type |
Возвращает тип рабочего листа. |
| UsedRange |
Возвращает объект Range, который представляет все ячейки, содержащие значение на данный момент. |
| Visible |
Возвращает или задает значение XlSheetVisibility, указывающее на то, является ли объект видимым. |
| VPageBreaks |
Возвращает коллекцию VPageBreaks, представляющую вертикальные разрывы страницы на листе. |
Методы
| Activate() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| BeginInit() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| CalculateMethod() |
Производит вычисление формул на рабочем листе. |
| ChartObjects(Object) |
Возвращает объект, представляющий либо отдельную внедренную диаграмму (объект ChartObject), либо коллекцию всех внедренных диаграмм (коллекция ChartObjects) на рабочем листе. |
| CheckSpelling(Object, Object, Object, Object) |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| CircleInvalid() |
Помечает кружками недопустимые значения на рабочем листе. |
| ClearArrows() |
Удаляет с рабочего листа стрелки трассировки. Стрелки трассировки добавляются с помощью функции аудита. |
| ClearCircles() |
Снимает кружки с недопустимых значений на рабочем листе. |
| Copy(Object, Object) |
Копирует лист в другое расположение в книге. |
| Delete() |
Удаляет базовый объект Worksheet, но не удаляет ведущий элемент. Настоятельно рекомендуется не использовать этот метод. |
| Dispose() |
Освобождает все ресурсы, используемые текущим экземпляром класса WorksheetBase. |
| EndInit() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Evaluate(Object) |
Преобразует имя Microsoft Office Excel в объект или значение. |
| ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object) |
Выполняет экспорт в файл указанного формата. |
| FinishInitialization() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| GetAutomationObject() |
Вызывается средой выполнения набор средств Visual Studio для Office для получения объекта, который может использоваться кодом VBA на листе. |
| Initialize() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| InitializeDataBindings() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Move(Object, Object) |
Перемещает рабочий лист в другое местоположение в рабочей книге. |
| OLEObjects(Object) |
Возвращает объект, представляющий либо отдельный объект OLE (объект OLEObject), либо коллекцию всех объектов OLE (коллекция OLEObjects) на рабочем листе. |
| OnShutdown() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| OnStartup() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Paste(Object, Object) |
Вставляет в рабочий лист содержимое буфера обмена. |
| PasteSpecial(Object, Object, Object, Object, Object, Object, Object) |
Вставляет в рабочий лист содержимое буфера обмена с использованием указанного формата. Данный метод используется для вставки данных из других приложений или вставки данных в определенном формате. |
| PivotTables(Object) |
Возвращает объект, представляющий либо отдельный отчет сводной таблицы (объект PivotTable), либо коллекцию всех отчетов сводных таблиц (коллекция PivotTables) на рабочем листе. |
| PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Создает объект PivotTable. |
| PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Печать рабочего листа. |
| PrintPreview(Object) |
Выводит лист в режиме предварительного просмотра для печати. |
| Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Защищает рабочий лист от изменений. |
| ResetAllPageBreaks() |
Сброс всех разрывов страницы на указанном рабочем листе. |
| SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object) |
Сохраняет изменения в рабочем листе в другой файл. |
| Scenarios(Object) |
Возвращает объект, представляющий либо отдельный скрипт (объект Scenario), либо коллекцию скриптов (коллекция Scenarios) на рабочем листе. |
| Select(Object) |
Выделение рабочего листа. |
| SetBackgroundPicture(String) |
Задает фоновое изображение для рабочего листа. |
| ShowAllData() |
Делает все строки фильтруемого списка видимыми. Если используется автофильтрация, вызов данного метода приводит к изменению стрелок на стрелки "Все". |
| ShowDataForm() |
Отображение формы данных, связанной с рабочим листом. |
| Unprotect(Object) |
Снимает защиту с рабочего листа. Если на рабочем листе нет защиты, этот метод не работает. |
| XmlDataQuery(String, Object, Object) |
Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath. Возвращает |
| XmlMapQuery(String, Object, Object) |
Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath. Возвращает |
События
| ActivateEvent |
Происходит при активации рабочего листа. |
| BeforeDoubleClick |
Происходит при двойном щелчке по листу перед вызовом обработчика двойного щелчка по умолчанию. |
| BeforeRightClick |
Происходит при щелчке правой кнопкой мыши любого листа перед вызовом обработчика щелчка правой кнопкой мыши по умолчанию. |
| BindingContextChanged |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| Calculate |
Происходит после пересчета рабочего листа. |
| Change |
Происходит, когда в ячейки WorksheetBase вносятся какие-либо изменения. |
| Deactivate |
Происходит при потере фокуса рабочим листом. |
| Disposed |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| FollowHyperlink |
Происходит при переходе по любой гиперссылке на листе. |
| PivotTableAfterValueChange |
Происходит после изменения или пересчета ячейки либо диапазона ячеек в сводной таблице (для ячеек, содержащих формулы). Это событие можно использовать только в проектах Excel 2010. |
| PivotTableBeforeAllocateChanges |
Происходит перед применением изменений к сводной таблице. Это событие можно использовать только в проектах Excel 2010. |
| PivotTableBeforeCommitChanges |
Происходит перед внесением изменений в источник данных OLAP для сводной таблицы. Это событие можно использовать только в проектах Excel 2010. |
| PivotTableBeforeDiscardChanges |
Происходит перед отменой изменений в сводной таблице. Это событие можно использовать только в проектах Excel 2010. |
| PivotTableChangeSync |
Происходит после изменений в сводной таблице. Это событие можно использовать только в проектах Excel 2010. |
| PivotTableUpdate |
Происходит при обновлении отчета сводной таблицы на рабочем листе. |
| SelectionChange |
Происходит при изменении выделения на листе. |
| Shutdown |
Происходит при закрытии ведущего элемента листа. |
| Startup |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
Явные реализации интерфейса
| EntryPoint.BeginInit() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.EndInit() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.FinishInitialization() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.Initialize() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.InitializeDataBindings() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.OnShutdown() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| EntryPoint.OnStartup() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| IExtension.ExtensionBase |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |
| IWorksheetExtension.GetAutomationObject() |
Предоставляет базовый класс для классов Sheetn в проектах на уровне документа для Microsoft Office Excel. |