OfficeExtension.ClientRequestContext class

Пакет:

office

Абстрактный объект RequestContext, облегчающий отправку запросов приложению Office. Методы Excel.run and Word.run предоставляют контекст запроса.

Комментарии

Используется

• Excel: запуск
• Excel.CustomFunctionManager: newObject
• Excel.DocumentTaskChange: newObject
• OfficeExtension.ClientObject: контекст
• OfficeExtension.EventHandlerResult: контекст
• OfficeExtension.RunOptions: previousObjects
• PowerPoint.Application: newObject
• PowerPoint.SensitivityLabelsCatalog: newObject
• Visio: запуск
• Word. Применение: newObject
• Word. SearchOptions: newObject
• Word. SensitivityLabelsCatalog: newObject

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

(constructor)(url)

Создает новый экземпляр ClientRequestContext класса

Свойства

debugInfo	Данные отладки
requestHeaders	Заголовки запросов
trackedObjects	Коллекция объектов, которые отслеживаются для автоматической корректировки на основе окружающих изменений в документе.

Методы

load(object, option)	Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().
loadRecursive(object, options, maxDepth)	Ставит команду в очереди для рекурсивной загрузки указанных свойств объекта и его свойств навигации. Перед чтением свойств требуется вызвать метод context.sync().
sync(passThroughValue)	Синхронизирует состояние между прокси-объектами JavaScript и документом Office, выполняя инструкции, поставленные в очередь в контексте запроса, и извлекая свойства загруженных объектов Office для использования в коде. Этот метод возвращает отложенный результат, который разрешается после завершения синхронизации.
trace(message)	Добавляет сообщение трассировки в очередь. Если обещание, возвращенное context.sync() , отклоняется из-за ошибки, это добавляет массив ".traceMessages" к объекту OfficeExtension.Error, содержащий все сообщения трассировки, которые были выполнены. Эти сообщения помогают отслеживать последовательность выполнения программы и определять причину ошибки.

Сведения о конструкторе

(constructor)(url)

Создает новый экземпляр ClientRequestContext класса

constructor(url?: string);

Параметры

url

string

Сведения о свойстве

debugInfo

Данные отладки

readonly debugInfo: RequestContextDebugInfo;

Значение свойства

OfficeExtension.RequestContextDebugInfo

requestHeaders

Заголовки запросов

requestHeaders: { [name: string]: string };

Значение свойства

{ [name: string]: string }

trackedObjects

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

trackedObjects: TrackedObjects;

Значение свойства

OfficeExtension.TrackedObjects

Сведения о методе

load(object, option)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(object: ClientObject, option?: string | string[] | LoadOption): void;

Параметры

object

OfficeExtension.ClientObject

Объект, свойства которого загружены.

option

string | string[] | OfficeExtension.LoadOption

Строка с разделителями-запятыми или массив строк, указывающий свойства для загрузки, или объект OfficeExtension.LoadOption .

Возвращаемое значение

void

loadRecursive(object, options, maxDepth)

Ставит команду в очереди для рекурсивной загрузки указанных свойств объекта и его свойств навигации.

Перед чтением свойств требуется вызвать метод context.sync().

loadRecursive(object: ClientObject, options: { [typeName: string]: string | string[] | LoadOption }, maxDepth?: number): void;

Параметры

object

OfficeExtension.ClientObject

Объект для загрузки.

options

{ [typeName: string]: string | string[] | OfficeExtension.LoadOption }

Пары "ключ-значение" параметров загрузки типов, таких как { "Workbook": "worksheets,tables", "Worksheet": "tables", "Tables": "name" }

maxDepth

number

Максимальная глубина рекурсии.

Возвращаемое значение

void

sync(passThroughValue)

Синхронизирует состояние между прокси-объектами JavaScript и документом Office, выполняя инструкции, поставленные в очередь в контексте запроса, и извлекая свойства загруженных объектов Office для использования в коде. Этот метод возвращает отложенный результат, который разрешается после завершения синхронизации.

sync<T>(passThroughValue?: T): Promise<T>;

Параметры

passThroughValue

T

Возвращаемое значение

Promise<T>

trace(message)

Добавляет сообщение трассировки в очередь. Если обещание, возвращенное context.sync() , отклоняется из-за ошибки, это добавляет массив ".traceMessages" к объекту OfficeExtension.Error, содержащий все сообщения трассировки, которые были выполнены. Эти сообщения помогают отслеживать последовательность выполнения программы и определять причину ошибки.

trace(message: string): void;

Параметры

message

string

Возвращаемое значение

void