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


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 IDisposable
Public 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, предоставляющий сведения об отфильтрованных списках на листе, если фильтрация включена. Получает объект null, если фильтрация выключена.

AutoFilterMode

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

Base

Получает или задает объект Worksheet, расширяемый данным объектом WorksheetBase.

BindingContext

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

Cells

Возвращает объект Range, представляющий все ячейки рабочего листа (а не только используемые в данный момент ячейки).

CircularReference

Возвращает объект Range, представляющий диапазон, который содержит первую циклическую ссылку на рабочем листе, либо возвращает null, если на рабочем листе нет циклических ссылок.

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. Возвращает null, если указанный XPath не сопоставлен с рабочим листом, или если сопоставленный диапазон пуст.

XmlMapQuery(String, Object, Object)

Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath. Возвращает null, если указанный 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.

Применяется к