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

Worksheet - интерфейс

  • Статья

Представляет лист в проектах Excel, созданных с помощью средств разработки Office в Visual Studio.

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

Синтаксис

'Декларация
<GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")> _
Public Interface Worksheet _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("297dc8d9-eabd-45a1-bdef-68ab67e5c3c3")]
public interface Worksheet : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

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

Свойства

  Имя Описание
Открытое свойство _CodeName Инфраструктура.
Открытое свойство _DisplayRightToLeft Инфраструктура.
Открытое свойство Application Данное свойство возвращает объект Microsoft.Office.Interop.Excel.Application, представляющий приложение Microsoft Office Excel.
Открытое свойство AutoFilter Получает объект Microsoft.Office.Interop.Excel.AutoFilter, предоставляющий информацию об отфильтрованных списках на листе, если фильтрация включена.Получает значение nullссылка NULL (Nothing в Visual Basic), если фильтрация выключена.
Открытое свойство AutoFilterMode Получает или задает значение, указывающее, включена ли фильтрация на листе в настоящий момент (т. е. указывает, отображаются ли стрелки раскрывающихся списков фильтрации в настоящий момент).
Открытое свойство BindingContext Возвращает или задает коллекцию диспетчеров валют для IBindableComponent. (Унаследовано от IBindableComponent.)
Открытое свойство Cells Возвращает объект Range, представляющий все ячейки рабочего листа (а не только используемые в данный момент ячейки).
Открытое свойство CircularReference Возвращает объект Range, представляющий диапазон, который содержит первую циклическую ссылку на рабочем листе, либо возвращает nullссылка 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 Возвращает коллекцию объектов привязки данных для данного IBindableComponent. (Унаследовано от IBindableComponent.)
Открытое свойство DataHost Инфраструктура.
Открытое свойство DefaultExtension Получает расширение по умолчанию для данного объекта Worksheet.
Открытое свойство DisplayAutomaticPageBreaks Инфраструктура.
Открытое свойство DisplayPageBreaks Возвращает или задает значение, определяющее отображение на рабочем листе разрывов страниц (установленных вручную или автоматически).
Открытое свойство DisplayRightToLeft Возвращает или задает значение, указывающее, должен ли рабочий лист отображаться справа налево, а не слева направо.
Открытое свойство EnableAutoFilter Возвращает или задает значение, определяющее отображение стрелок автофильтрации при использовании защиты только пользовательского интерфейса.
Открытое свойство EnableCalculation Возвращает или задает значение, определяющее, будет ли Microsoft Office Excel производить автоматический перерасчет рабочего листа при необходимости.
Открытое свойство EnableFormatConditionsCalculation Возвращает или задает значение, указывающее на использование автоматической оценки условных форматов.
Открытое свойство EnableOutlining Возвращает или задает значение, определяющее отображение символов структуры при использовании защиты только пользовательского интерфейса.
Открытое свойство EnablePivotTable Возвращает или задает значение, определяющее возможность использования элементов управления и функций сводных таблиц при применении защиты только пользовательского интерфейса.
Открытое свойство EnableSelection Возвращает или задает значение, определяющее ячейки на листе, которые могут быть выделены.
Открытое свойство Extension Получает пользовательское расширение для данного объекта Worksheet.
Открытое свойство FilterMode Получает значение, указывающее, выполняется ли на листе активная фильтрация данных.
Открытое свойство HostContext Инфраструктура.
Открытое свойство HPageBreaks Возвращает коллекцию Microsoft.Office.Interop.Excel.HPageBreaks, представляющую горизонтальные разрывы страницы на листе.
Открытое свойство Hyperlinks Возвращает коллекцию Microsoft.Office.Interop.Excel.Hyperlinks, представляющую гиперссылки на диапазон или лист.
Открытое свойство Index Возвращает номер индекса рабочего листа в пределах коллекции рабочих листов.
Открытое свойство InnerObject Получает объект Microsoft.Office.Interop.Excel.Worksheet, представляющий собственный базовый объект для объекта Worksheet.
Открытое свойство 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 Получает число страниц примечаний, которые будут печататься для текущего листа.
Открытое свойство 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 Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.)
Открытое свойство 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, представляющую вертикальные разрывы страницы на листе.

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

Методы

  Имя Описание
Открытый метод _CheckSpelling Инфраструктура.
Открытый метод _Evaluate Инфраструктура.
Открытый метод _PasteSpecial Инфраструктура.
Открытый метод _PrintOut Инфраструктура.
Открытый метод _Protect Инфраструктура.
Открытый метод _SaveAs Инфраструктура.
Открытый метод _VtblGap1_1
Открытый метод _VtblGap2_1
Открытый метод _VtblGap3_1
Открытый метод _VtblGap4_1
Открытый метод _VtblGap5_1
Открытый метод _VtblGap6_1
Открытый метод _VtblGap7_1
Открытый метод Activate Делает текущий лист активным.
Открытый метод Arcs Инфраструктура.
Открытый метод BeginInit Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.)
Открытый метод 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 Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
Открытый метод DrawingObjects Инфраструктура.
Открытый метод Drawings Инфраструктура.
Открытый метод DropDowns Инфраструктура.
Открытый метод EndInit Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.)
Открытый метод Evaluate Преобразует имя Microsoft Office Excel в объект или значение.
Открытый метод ExportAsFixedFormat Экспортирует в файл указанного формата.
Открытый метод get_Range Возвращает объект Microsoft.Office.Interop.Excel.Range, представляющий ячейку или диапазон ячеек.Вместо этого метода можно использовать свойство Range.
Открытый метод GroupBoxes Инфраструктура.
Открытый метод GroupObjects Инфраструктура.
Открытый метод Labels Инфраструктура.
Открытый метод Lines Инфраструктура.
Открытый метод ListBoxes Инфраструктура.
Открытый метод Move Перемещает рабочий лист в другое местоположение в рабочей книге.
Открытый метод OLEObjects Возвращает объект, представляющий либо отдельный объект OLE (объект Microsoft.Office.Interop.Excel.OLEObject), либо коллекцию всех объектов OLE (коллекция Microsoft.Office.Interop.Excel.OLEObjects) на рабочем листе.
Открытый метод 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 Инфраструктура.
Открытый метод Unprotect Снимает защиту с рабочего листа.Если на рабочем листе нет защиты, этот метод не работает.
Открытый метод XmlDataQuery Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath.Возвращает nullссылка NULL (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом, или если сопоставленный диапазон пуст.
Открытый метод XmlMapQuery Возвращает объект Range, представляющий ячейки, сопоставленные с определенным XPath.Возвращает nullссылка NULL (Nothing в Visual Basic), если указанный XPath не сопоставлен с рабочим листом.

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

События

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

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

Заметки

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

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

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

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

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

В проектах уровня документа объект Microsoft.Office.Tools.Excel.Worksheet обычно не используется непосредственно.Вместо этого используйте классы Sheetn для программного доступа к листам в проекте.Каждый класс Sheetn производит большинство своих членов от класса Microsoft.Office.Tools.Excel.WorksheetBase.Этот класс перенаправляет все вызовы своих членов во внутреннюю реализацию интерфейса Microsoft.Office.Tools.Excel.Worksheet в Visual Studio Tools for Office (cреда выполнения).Дополнительные сведения см. в разделе Настройки программирования уровня документа.

ПримечаниеПримечание

Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

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

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

См. также

Ссылки

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

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

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

Ведущие элементы листа