Ewa.AsyncResult.getCode()

**適用対象:**apps for SharePoint | Excel Services | SharePoint Server 2013

この記事の内容
戻り値
注釈
例

指定された非同期メソッドの呼び出しのリターン コードを取得します。

var value = Ewa.AsyncResult.getCode();

戻り値

[Type]: AsyncErrorCode 列挙

注釈

**[AsyncResult]オブジェクトは、非同期メソッドの呼び出しで指定されたコールバックに引数として渡されます。[AsyncResult]オブジェクトには、非同期の操作をことによって得リターン コードが含まれています。[AsyncResult.getCode]メソッドは、成功または失敗の操作を指定する[AsyncErrorCode]列挙として戻り値を返します。非同期操作が正常に終了[AsyncResult.getCode][AsyncErrorCode.Success]**が返されます。

非同期操作中にエラーが発生する場合は、 **[AsyncResult.getCode]はエラーを説明する[AsyncErrorCode]**列挙定数を返します。

例

次の例では、非同期の範囲を取得する方法を示し、 AsyncResult.getCodeメソッドを使用して、[ **[AsyncResult]**オブジェクトからエラー コードを取得します。コードの例をExcel Web Access Web パーツでSharePoint Server 2013で作業していることを前提としています。

<script type="text/javascript">
     
var ewa = null;
    
// Add event handler for onload event.
if (window.attachEvent) 
{ 
    window.attachEvent("onload", ewaOnPageLoad);    
} 
else 
{ 
    window.addEventListener("DOMContentLoaded", ewaOnPageLoad, false); 
}

// Add event handler for applicationReady event.
function ewaOnPageLoad() 
{         
    Ewa.EwaControl.add_applicationReady(getEwa); 
} 

function getEwa()
{
    // Get a reference to the Ewa object.
    ewa = Ewa.EwaControl.getInstances().getItem(0);
    getRangeAsync();
}

function getRangeAsync()
{
    // Get a range asynchronously using A1 notation.
    ewa.getActiveWorkbook().getRangeA1Async("Sheet3!B2", getRangeComplete, null);
}

function getRangeComplete(asyncResult)
{    
    // If getRangeA1Async failed, get error code.
    if (!asyncResult.getSucceeded())
    {
       // Get the error code.
        var errorCode = asyncResult.getCode();
        switch (errorCode)
        {
            case Ewa.AsyncErrorCode.InternalError:
                alert("An internal error occurred.");
                break;
            case Ewa.AsyncErrorCode.TimedOut:
                alert("The operation timed out.");
                break;            
            case Ewa.AsyncErrorCode.InvalidNamedItem:
                alert("The named item is undefined or unpublished.");
                break;
            case Ewa.AsyncErrorCode.SettingValuesError:
                alert("Excel Calculation Services is unable to set the values.");
                break;
            case Ewa.AsyncErrorCode.RangeSizeError:
                alert("The array indices exceed the range columns and/or rows. Or the range columns and/or rows exceed the array indices.");
                break;            
        } // End switch.
    } // End if.
    
    // Get the range object from the getRangeA1Async call
    var range = asyncResult.getReturnValue();
       
    // Display the range address in A1 format
    window.status = range.getAddressA1();
}
</script>

関連項目

参照先

Ewa.AsyncResult 方法

概念

Ewa 名前空間