Worksheet Интерфейс

Определение

Пространство имен:: Microsoft.Office.Interop.Excel

Сборка:: Microsoft.Office.Interop.Excel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет лист.

public interface class Worksheet : Microsoft::Office::Interop::Excel::_Worksheet, Microsoft::Office::Interop::Excel::DocEvents_Event

[System.Runtime.InteropServices.Guid("000208D8-0000-0000-C000-000000000046")]
public interface Worksheet : Microsoft.Office.Interop.Excel._Worksheet, Microsoft.Office.Interop.Excel.DocEvents_Event

Public Interface Worksheet
Implements _Worksheet, DocEvents_Event

Производный: Microsoft.Office.Interop.Excel.WorksheetClass

Атрибуты: GuidAttribute

Реализации: _Worksheet DocEvents_Event

Это интерфейс .NET, полученный из компонентного класса COM, который требуется управляемому программному коду для взаимодействия с соответствующим объектом COM. Используйте этот вторичный интерфейс для доступа ко всем методам, свойствам и членам событий объекта COM. Однако если метод или событие, которые требуется использовать, имеют одно и то же имя в каком-либо объекте COM, для вызова метода приведите к соответствующему основному интерфейсу, для соединения с событием приведите к интерфейсу последних событий. Для получения дополнительной информации об объекте COM обращайтесь к этому разделу. Сведения о методе и свойствах-членах COM-объекта см. в статье _Worksheet.

Объект листа является частью семейства Worksheets . Коллекция "Листы " содержит все объекты листа в книге.

В этом разделе описаны следующие свойства для возврата объекта листа .

Worksheets свойство
ActiveSheet свойство

Свойство листов

Чтобы вернуть один объект листа, используйте команду Worksheets(index), где index — порядковый номер или имя листа.

Порядковый номер листа определяет его положение на панели табуляции. Worksheets(1) — первый (крайний левый) лист в книге, а Worksheets(Worksheets.Count) — последний. В индекс включаются все листы, даже если они скрыты.

Имя листа отображается на вкладке листа. Это свойство Name позволяет задать или вернуть имя листа.

Объект листа также входит в семейство Sheets . Коллекция "Листы " содержит все листы книги (листы диаграмм и листы).

Свойство ActiveSheet

Если лист является активным, для ссылки на него можно использовать свойство "Активный лист ".

Свойства

Имя	Описание
_CodeName	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_DisplayRightToLeft	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Application	Если оно не является ограничителем объектов, это свойство возвращает объект, представляющий Application приложение Microsoft Excel. Если используется с квалификатором объекта, это свойство возвращает объект Application, который представляет создателя указанного объекта (вы можете задать это свойство с объектом OLE-автоматизации для возврата приложения этого объекта). Только для чтения. (Унаследовано от _Worksheet)
AutoFilter	Возвращает объект, AutoFilter если фильтрация включена. Ничего не возвращает, если фильтрация отключена. Только для чтения. (Унаследовано от _Worksheet)
AutoFilterMode	Имеет значение "True ", если на листе отображаются стрелки раскрывающегося списка "Автофильтр". Это свойство не зависит от FilterMode свойства. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
Cells	Возвращает объект, Range который представляет все ячейки листа (а не только ячейки, которые используются в данный момент). Только для чтения. (Унаследовано от _Worksheet)
CircularReference	Возвращает Range объект, представляющий диапазон, содержащий первую циклическую ссылку на листе, или возвращает значение Nothing , если на листе нет циклической ссылки. Циклическую ссылку необходимо удалить, прежде чем можно будет продолжить вычисления. Только для чтения. (Унаследовано от _Worksheet)
CodeName	Возвращает кодовое имя объекта. Только для чтения, String. (Унаследовано от _Worksheet)
Columns	Возвращает объект, Range представляющий все столбцы указанного листа. Только для чтения. (Унаследовано от _Worksheet)
Comments	Возвращает Comments коллекцию, представляющую все примечания указанного листа. Только для чтения. (Унаследовано от _Worksheet)
ConsolidationFunction	Возвращает код функции, используемый для консолидации в текущий. Может быть одной из XlConsolidationFunction констант. Только для чтения. (Унаследовано от _Worksheet)
ConsolidationOptions	Возвращает массив параметров консолидации из трех элементов, как показано в следующей таблице. Если элемент имеет значение True, этот параметр установлен. Объект только для чтения. (Унаследовано от _Worksheet)
ConsolidationSources	Возвращает массив строковых значений, присвоивших имена исходным листам для текущей консолидации на листе. Возвращает пустое значение, если на листе нет консолидации. Объект только для чтения. (Унаследовано от _Worksheet)
Creator	Возвращает константу XlCreator в перечислении, указывающую приложение, в котором был создан этот объект. Если объект создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную шестнадцатеричному числу 5843454C. Доступный только для чтения файл xlCreatorCode. (Унаследовано от _Worksheet)
CustomProperties	Возвращает объект, CustomProperties представляющий сведения об идентификаторе, связанные с листом. (Унаследовано от _Worksheet)
DisplayAutomaticPageBreaks	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
DisplayPageBreaks	Имеет значение "True", если на указанном листе отображаются разрывы страниц (автоматические и ручные). Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
DisplayRightToLeft	Имеет значение "True ", если указанное окно, лист или объект ListObject отображаются справа налево, а не слева направо. Значение false , если объект отображается слева направо. Только для чтения, Boolean. (Унаследовано от _Worksheet)
EnableAutoFilter	Имеет значение "True", если стрелки автофильтра включены, когда включена защита только пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
EnableCalculation	Имеет значение "True ", если Microsoft Excel автоматически пересчитывает лист при необходимости. Значение false , если Excel не пересчитывает лист. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
EnableFormatConditionsCalculation	Возвращает или задает применение условного форматирования автоматически по мере необходимости. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
EnableOutlining	True , если символы структуры включены, когда включена защита только пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
EnablePivotTable	Имеет значение "True", если элементы управления и действия сводной таблицы включены, когда включена защита только пользовательского интерфейса. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
EnableSelection	Возвращает или задает элементы, которые можно выбрать на листе. Чтение и запись XlEnableSelection. (Унаследовано от _Worksheet)
FilterMode	Значение True , если лист находится в режиме фильтра. Только для чтения, Boolean. (Унаследовано от _Worksheet)
HPageBreaks	Возвращает HPageBreaks коллекцию, которая представляет горизонтальные разрывы страниц на листе. Только для чтения. (Унаследовано от _Worksheet)
Hyperlinks	Возвращает Hyperlinks коллекцию, представляющую гиперссылки для диапазона или листа. (Унаследовано от _Worksheet)
Index	Возвращает номер индекса объекта в семействе похожих объектов. Только для чтения, Integer. (Унаследовано от _Worksheet)
ListObjects	Возвращает набор ListObject объектов на листе. Коллекция ListObjects только для чтения. (Унаследовано от _Worksheet)
MailEnvelope	Представляет заголовок сообщения электронной почты для документа. (Унаследовано от _Worksheet)
Name	Возвращает или задает имя объекта. Для чтения и записи, String. (Унаследовано от _Worksheet)
Names	Возвращает семейство Names , представляющее все имена, относящиеся к листу (имена, определенные с помощью префикса "Имялиста!"). объект "Имена " только для чтения. (Унаследовано от _Worksheet)
Next	Возвращает Chartзнак , Rangeили Worksheet объект, представляющий следующий лист или ячейку. Только для чтения. (Унаследовано от _Worksheet)
OnCalculate	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
OnData	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
OnDoubleClick	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
OnEntry	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
OnSheetActivate	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
OnSheetDeactivate	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Outline	Возвращает Outline объект, который представляет структуру указанного листа. Только для чтения. (Унаследовано от _Worksheet)
PageSetup	Возвращает объект, PageSetup содержащий все параметры страницы для указанного объекта. Только для чтения. (Унаследовано от _Worksheet)
Parent	Возвращает родительский объект для указанного объекта. Только для чтения. (Унаследовано от _Worksheet)
Previous	Возвращает Chartзначение , Rangeили Worksheet объект, представляющий предыдущий лист или ячейку. Только для чтения. (Унаследовано от _Worksheet)
PrintedCommentPages	Получает количество страниц примечаний, которые будут напечатаны для текущего листа. (Унаследовано от _Worksheet)
ProtectContents	True , если содержимое листа защищено. Для диаграммы это защищает всю диаграмму. При защите отдельных ячеек на листе сохраняется. Только для чтения, Boolean. (Унаследовано от _Worksheet)
ProtectDrawingObjects	True , если фигуры защищены. Только для чтения, Boolean. (Унаследовано от _Worksheet)
Protection	Возвращает объект, Protection представляющий параметры защиты листа. (Унаследовано от _Worksheet)
ProtectionMode	True , если включена защита только с помощью пользовательского интерфейса. Чтобы включить защиту пользовательского интерфейса, используйте метод с аргументом Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)`UserInterfaceOnly`True. Только для чтения, Boolean. (Унаследовано от _Worksheet)
ProtectScenarios	Значение True , если сценарии листа защищены. Только для чтения, Boolean. (Унаследовано от _Worksheet)
QueryTables	Возвращает QueryTables коллекцию, представляющую все таблицы запросов на указанном листе. Только для чтения. (Унаследовано от _Worksheet)
Range[Object, Object]	Возвращает объект, Range представляющий ячейку или диапазон ячеек. (Унаследовано от _Worksheet)
Rows	Возвращает объект, Range представляющий все строки указанного листа. Объект Range предназначен только для чтения. (Унаследовано от _Worksheet)
Scripts	Возвращает Scripts коллекцию, содержащую Script объекты, представляющие блоки сценария или кода в указанном документе, если он сохранен как веб-страница. (Унаследовано от _Worksheet)
ScrollArea	Возвращает или задает диапазон, в котором разрешена прокрутка в качестве ссылки на диапазон в стиле A1. Ячейки за пределами области прокрутки выделить невозможно. Для чтения и записи, String. (Унаследовано от _Worksheet)
Shapes	Возвращает объект, Shapes представляющий все фигуры листа или листа диаграммы. Только для чтения. (Унаследовано от _Worksheet)
SmartTags	Возвращает объект, SmartTags представляющий идентификатор указанной ячейки. (Унаследовано от _Worksheet)
Sort	Возвращает отсортированные значения на текущем листе. Только для чтения. (Унаследовано от _Worksheet)
StandardHeight	Возвращает стандартную высоту (высоту по умолчанию) всех строк листа в точках. Только для чтения, Double. (Унаследовано от _Worksheet)
StandardWidth	Возвращает или задает стандартную (по умолчанию) ширину всех столбцов на листе. Для чтения и записи, Double. (Унаследовано от _Worksheet)
Tab	Возвращает Tab объект для диаграммы или листа. (Унаследовано от _Worksheet)
TransitionExpEval	True , если Microsoft Excel использует правила оценки выражений Lotus 1-2-3 для листа. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
TransitionFormEntry	True , если Microsoft Excel использует правила ввода формул Lotus 1-2-3 для листа. Для чтения и записи, Boolean. (Унаследовано от _Worksheet)
Type	Возвращает или задает тип листа. Только XlSheetTypeдля чтения. (Унаследовано от _Worksheet)
UsedRange	Возвращает объект, Range представляющий используемый диапазон на указанном листе. Только для чтения. (Унаследовано от _Worksheet)
Visible	Определяет, отображается ли объект. Чтение и запись XlSheetVisibility. (Унаследовано от _Worksheet)
VPageBreaks	Возвращает VPageBreaks коллекцию, представляющую вертикальные разрывы страниц на листе. Только для чтения. (Унаследовано от _Worksheet)

Методы

Имя	Описание
_CheckSpelling(Object, Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_Evaluate(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_PasteSpecial(Object, Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_PrintOut(Object, Object, Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_Protect(Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
_SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Arcs(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Buttons(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
ChartObjects(Object)	Возвращает объект, представляющий либо одну внедренную диаграмму ChartObject (объект), либо коллекцию всех внедренных диаграмм ( ChartObjects объект) на листе. (Унаследовано от _Worksheet)
CheckBoxes(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
CheckSpelling(Object, Object, Object, Object)	Проверяет орфографию объекта. Эта форма не имеет возвращаемого значения; Откроется диалоговое окно "Орфография". (Унаследовано от _Worksheet)
CircleInvalid()	Обводит недопустимые записи на листе. (Унаследовано от _Worksheet)
ClearArrows()	Удаление стрелок трассировки с листа. Стрелки трассировки добавляются с помощью функции аудита. (Унаследовано от _Worksheet)
ClearCircles()	Удаляет кружки от недопустимых записей на листе. (Унаследовано от _Worksheet)
Copy(Object, Object)	Копирование листа в другое место в книге. (Унаследовано от _Worksheet)
Delete()	Удаляет объект. (Унаследовано от _Worksheet)
DrawingObjects(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Drawings(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
DropDowns(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Evaluate(Object)	Преобразует имя Microsoft Excel в объект или значение. (Унаследовано от _Worksheet)
ExportAsFixedFormat(XlFixedFormatType, Object, Object, Object, Object, Object, Object, Object, Object)	Экспорт в файл заданного формата. (Унаследовано от _Worksheet)
GroupBoxes(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
GroupObjects(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Labels(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Lines(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
ListBoxes(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Move(Object, Object)	Перемещение листа в другое место в книге (Унаследовано от _Worksheet)
OLEObjects(Object)	Возвращает объект, представляющий один OLE-объект (OLE OLEObject) или коллекцию всех OLE-объектов (семейство OLEObjects ) на диаграмме или листе. Только для чтения. (Унаследовано от _Worksheet)
OptionButtons(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Ovals(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Paste(Object, Object)	Вставка содержимого буфера обмена на лист. (Унаследовано от _Worksheet)
PasteSpecial(Object, Object, Object, Object, Object, Object, Object)	Вставляет содержимое буфера обмена на лист в указанном формате. Этот метод используется для вставки данных из других приложений или для вставки данных в определенный формат. (Унаследовано от _Worksheet)
Pictures(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
PivotTables(Object)	Возвращает объект, представляющий один отчет сводной таблицы PivotTable (объект) или коллекцию всех отчетов сводной таблицы ( PivotTables объект) на листе. Только для чтения. (Унаследовано от _Worksheet)
PivotTableWizard(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Создает PivotTable объект. Этот метод не отображает мастер сводных таблиц. Этот метод недоступен для источников данных OLE DB. Используйте Add(Object, Object, Object, Object) этот метод, чтобы добавить кэш сводной таблицы, а затем создать отчет сводной таблицы на основе кэша. объекта сводной таблицы . (Унаследовано от _Worksheet)
PrintOut(Object, Object, Object, Object, Object, Object, Object, Object)	Печатает объект. (Унаследовано от _Worksheet)
PrintOutEx(Object, Object, Object, Object, Object, Object, Object, Object, Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
PrintPreview(Object)	Предварительный просмотр объекта в том виде, в котором он выглядел бы при печати. (Унаследовано от _Worksheet)
Protect(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Защищает лист, чтобы его нельзя было изменить. (Унаследовано от _Worksheet)
Rectangles(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
ResetAllPageBreaks()	Сбрасывает все разрывы страниц на указанном листе. (Унаследовано от _Worksheet)
SaveAs(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Сохраняет изменения на диаграмме или листе в другом файле. (Унаследовано от _Worksheet)
Scenarios(Object)	Возвращает объект, представляющий один сценарий ( Scenario объект) или совокупность сценариев ( Scenarios объект) на листе. (Унаследовано от _Worksheet)
ScrollBars(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Select(Object)	Выделение объекта. (Унаследовано от _Worksheet)
SetBackgroundPicture(String)	Задает фоновый рисунок листа или диаграммы. (Унаследовано от _Worksheet)
ShowAllData()	Отображение всех строк отфильтрованного списка. Если используется автофильтр, стрелки этого метода изменяются на "Все". (Унаследовано от _Worksheet)
ShowDataForm()	Отображает форму данных, связанную с листом. (Унаследовано от _Worksheet)
Spinners(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
TextBoxes(Object)	Зарезервировано для внутреннего использования. (Унаследовано от _Worksheet)
Unprotect(Object)	Снимает защиту с листа или книги. Этот метод не действует, если лист или книга не защищены. (Унаследовано от _Worksheet)
XmlDataQuery(String, Object, Object)	Возвращает объект, Range представляющий ячейки, сопоставленные с определенным объектом XPath. Ничего не возвращает, если указанный XPath не сопоставлен с листом или сопоставленный диапазон пуст. (Унаследовано от _Worksheet)
XmlMapQuery(String, Object, Object)	Возвращает объект, Range представляющий ячейки, сопоставленные с определенным объектом XPath. Ничего не возвращает, если указанный объект XPath не сопоставлен с листом. (Унаследовано от _Worksheet)

События

Имя	Описание
Activate	Возникает при активации листа. (Унаследовано от DocEvents_Event)
BeforeDelete	Событие BeforeDelete происходит перед удалением любого листа. (Унаследовано от DocEvents_Event)
BeforeDoubleClick	Возникает при двойном щелчке листа перед выполнением двойного щелчка по умолчанию. (Унаследовано от DocEvents_Event)
BeforeRightClick	Возникает при щелчке правой кнопкой мыши на листе перед действием по умолчанию — правой кнопкой мыши. (Унаследовано от DocEvents_Event)
Calculate	Возникает после пересчета листа. (Унаследовано от DocEvents_Event)
Change	Возникает при изменении ячеек листа пользователем или внешней ссылкой. (Унаследовано от DocEvents_Event)
Deactivate	Возникает при деактивации листа. (Унаследовано от DocEvents_Event)
FollowHyperlink	Возникает при щелчке по любой гиперссылке на листе. Сведения о событиях уровня приложений и книг см. в событии SheetFollowHyperlink . (Унаследовано от DocEvents_Event)
LensGalleryRenderComplete	Возникает, когда отображение значков коллекции выносок (динамических и статических) завершено. (Унаследовано от DocEvents_Event)
PivotTableAfterValueChange	Возникает после изменения или пересчета ячейки или диапазона ячеек внутри сводной таблицы (для ячеек, содержащих формулы). (Унаследовано от DocEvents_Event)
PivotTableBeforeAllocateChanges	Происходит до применения изменений к сводной таблице. (Унаследовано от DocEvents_Event)
PivotTableBeforeCommitChanges	Происходит перед фиксацией изменений в источнике данных OLAP для сводной таблицы. (Унаследовано от DocEvents_Event)
PivotTableBeforeDiscardChanges	Происходит до того, как изменения, внесенные в сводную таблицу, будут отменены. (Унаследовано от DocEvents_Event)
PivotTableChangeSync	Возникает после внесения изменений в сводную таблицу. (Унаследовано от DocEvents_Event)
PivotTableUpdate	Возникает после обновления отчета сводной таблицы на листе. (Унаследовано от DocEvents_Event)
SelectionChange	Возникает при изменении выделения на листе. (Унаследовано от DocEvents_Event)
TableUpdate	Возникает после обновления таблицы запросов, подключенной к модели данных, на листе. (Унаследовано от DocEvents_Event)

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

Обратная связь

Были ли сведения на этой странице полезными?