Office.AsyncResult interface

Пакет:
office

Объект, который инкапсулирует результат асинхронного запроса, включая сведения о состоянии и ошибке, если запрос завершился ошибкой.

Когда функция, которую вы передаете callback в параметр «асинхронного» метода, выполняется, она получает объект AsyncResult, доступ к которому можно получить из единственного параметра callback функции.

Комментарии

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

Примеры

// The following is an example applicable to content and task pane add-ins.
// The example shows a call to the getSelectedDataAsync method of the Document object.
Office.context.document.getSelectedDataAsync(
    Office.CoercionType.Text,
    {
        valueFormat: Office.ValueFormat.Unformatted,
        filterType: Office.FilterType.All
    },
    (result) => {
        if (result.status === Office.AsyncResultStatus.Succeeded) {
            const dataValue = result.value; // Get selected data.
            console.log('Selected data is ' + dataValue);
        } else {
            const err = result.error;
            console.log(err.name + ": " + err.message);
        }
    }
);
// The anonymous function passed as the callback argument ((result) => {...}) has a single 
// parameter named result that provides access to an AsyncResult object when the function executes.
// When the call to the getSelectedDataAsync method completes, the callback function executes, 
// and the following line of code accesses the value property of the AsyncResult object to 
// return the data selected in the document:
// const dataValue = result.value;
// Note that other lines of code in the function use the result parameter of the callback function 
// to access the status and error properties of the AsyncResult object.

Свойства

asyncContext

Получает пользовательский элемент, переданный в необязательный asyncContext параметр вызываемого метода в том же состоянии, в котором он был передан. Это возвращает определяемый пользователем элемент (который может быть любого типа JavaScript: String, Number, Boolean, Object, Array, Null или Undefined), переданный в необязательный asyncContext параметр вызываемого метода. Возвращает значение Undefined, если параметр asyncContext не был указан.
diagnostics

Получает объект, который может предоставить дополнительные сведения, если произошла ошибка .
error

Получает объект Office.Error , предоставляющий описание ошибки, если она возникла.
status

Получает Office.AsyncResultStatus асинхронной операции.
value

Получает полезные данные или содержимое асинхронной операции (если имеется).

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

asyncContext

Получает пользовательский элемент, переданный в необязательный asyncContext параметр вызываемого метода в том же состоянии, в котором он был передан. Это возвращает определяемый пользователем элемент (который может быть любого типа JavaScript: String, Number, Boolean, Object, Array, Null или Undefined), переданный в необязательный asyncContext параметр вызываемого метода. Возвращает значение Undefined, если параметр asyncContext не был указан.

asyncContext: any;

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

any

Примеры

function getDataWithContext() {
    const format = "Your data: ";
    Office.context.document.getSelectedDataAsync(
        Office.CoercionType.Text, 
        { asyncContext: format }, 
        showDataWithContext);
}

function showDataWithContext(asyncResult) {
    write(asyncResult.asyncContext + asyncResult.value);
}
// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

diagnostics

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

diagnostics: any;

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

any

Комментарии

Это свойство возвращает дополнительные сведения, если следующие ошибки возникают с этими поддерживаемыми API.

Поддерживаемые API

Office.context.mailbox.item.getCallbackTokenAsync , Office.context.mailbox.item.getUserIdentityTokenAsync

Поддерживаемые ошибки

AsyncResult.error.name AsyncResult.error.message Описание возвращаемого объекта диагностики
HTTPRequestFailure Не удалось выполнить запрос. Просмотрите объект диагностики для кода ошибки HTTP. Код ошибки HTTP в объекте JSON, {"HTTPCode":"401"}например .
InternalServerError Сервер Exchange Server вернул ошибку. Для получения дополнительных сведений просмотрите объект диагностики. сообщение об ошибке с сервера Exchange в объекте JSON, {"ErrorText": "The mailbox database is temporarily unavailable"}например .

error

Получает объект Office.Error , предоставляющий описание ошибки, если она возникла.

error: Office.Error;

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

Office.Error

Примеры

function getData() {
    Office.context.document.getSelectedDataAsync(Office.CoercionType.Table, function(asyncResult) {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            write(asyncResult.error.message);
        } else {
            write(asyncResult.value);
        }
    });
}
// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

status

Получает Office.AsyncResultStatus асинхронной операции.

status: AsyncResultStatus;

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

Office.AsyncResultStatus

Примеры

function getData() {
    Office.context.document.getSelectedDataAsync(Office.CoercionType.Table, function(asyncResult) {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            write(asyncResult.error.message);
        } else {
            write(asyncResult.value);
        }
    });
}
// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}

value

Получает полезные данные или содержимое асинхронной операции (если имеется).

value: T;

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

T

Комментарии

Вы обращаетесь к объекту AsyncResult в функции, переданной в качестве аргумента параметра обратного вызова «асинхронного» метода, такого как getSelectedDataAsync и методы объекта setSelectedDataAsyncDocument .

Примечание. Значение, возвращаемое свойством для конкретного "асинхронного" метода, зависит от назначения и контекста этого метода. To determine what is returned by the value property for an "Async" method, refer to the "Callback value" section of the method's topic.

Примеры

function getData() {
    Office.context.document.getSelectedDataAsync(Office.CoercionType.Table, function(asyncResult) {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            write(asyncResult.error.message);
        } else {
            write(asyncResult.value);
        }
    });
}
// Function that writes to a div with id='message' on the page.
function write(message) {
    document.getElementById('message').innerText += message;
}