Office.Error interface

Paket:

office

Stellt spezifische Informationen zu einem Fehler bereit, der bei einem asynchronen Datenvorgang aufgetreten ist.

Hinweise

Der Zugriff auf das Error-Objekt erfolgt über das AsyncResult-Objekt, das in der Funktion zurückgegeben wird, die als Rückrufargument eines asynchronen Datenvorgangs übergeben wird, z. B. die setSelectedDataAsync Methode des Document-Objekts.

Eigenschaften

code	Ruft den numerischen Code des Fehlers ab. Eine Liste der Fehlercodes finden Sie unter JavaScript-API für Office-Fehlercodes.
message	Ruft eine ausführliche Beschreibung des Fehlers ab.
name	Ruft den Namen des Fehlers ab.

Details zur Eigenschaft

code

Ruft den numerischen Code des Fehlers ab. Eine Liste der Fehlercodes finden Sie unter JavaScript-API für Office-Fehlercodes.

code: number;

Eigenschaftswert

number

Beispiele

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === "failed")
                const error = asyncResult.error;
            write(error.name + ": " + error.code + " - " + error.message);
        });
}

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

message

Ruft eine ausführliche Beschreibung des Fehlers ab.

message: string;

Eigenschaftswert

string

Beispiele

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === "failed")
                const error = asyncResult.error;
            write(error.name + ": " + error.message);
        });
}

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

name

Ruft den Namen des Fehlers ab.

name: string;

Eigenschaftswert

string

Beispiele

// To cause an error to be thrown, select a table or a matrix, and then call the setText function.
function setText() {
    Office.context.document.setSelectedDataAsync("Hello World!",
        function (asyncResult) {
            if (asyncResult.status === "failed")
                const error = asyncResult.error;
            write(error.name + ": " + error.message);
        });
}

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