匯出 (0) 列印
全部展開

table 物件

更新日期: 2013年1月

提供用以處理特定資料表的功能。

這個物件包含以下成員:

del

從資料表刪除指定的項目。

語法

Table.del(itemOrId, options)

參數

 

參數 說明

itemID

具有指定之識別碼的項目或資料列。

傳回值

未定義。

 

語法 傳回值 說明

del

 

未定義

 

insert

Table.insert(item, options)

未定義

將指定的 item 插入至指定的 tableName

orderBy

Table.orderBy(arg1, arg2, …)

Query 物件

傳回 Query 物件執行個體,代表依據提供的資料行名稱引數以遞增順序排序的查詢。

orderByDescending

Table.orderByDescending(arg1, arg2, …)

Query 物件

傳回 Query 物件執行個體,代表依據提供的資料行名稱引數以遞減順序排序的查詢。

read

Table.read(options)

未定義

從資料表讀取所有資料並傳入結果陣列以叫用由 options 參數指定的 success 處理常式。

Important重要事項
切勿對未限制大小的資料表呼叫 read 方法。

select

Table.select(string)

Query 物件

傳回已套用所要求之 string 投射的 Query 物件執行個體。

Table.select(function)

Query 物件

傳回已套用所要求之 function 投射的 Query 物件執行個體。

skip

Table.skip(recordCount)

Query 物件

傳回已略過前 recordCount 筆記錄的 Query 物件執行個體。

take

Table.take(recordCount)

Query 物件

傳回將會傳回 recordCount 筆記錄的 Query 物件執行個體。

where

Table.where(object)

Query 物件

傳回已根據所提供的 JSON object 屬性值進行篩選的 Query 物件執行個體。

Table.where(function)

Query 物件

傳回已根據所提供的 function 進行篩選的 Query 物件執行個體。

update

Table.update(item, options)

未定義

更新指定的 tableName 中,指定的 item

insertupdatedel 方法都接受 options 物件,此物件可能定義了成功或錯誤處理常式。

查詢方法 (orderByorderByDescendingselectskiptakewhere) 全都是傳回 Query 物件。此物件公開如前所述的各種方法,讓您可將查詢撰寫成一連串的方法呼叫。

下列指令碼呼叫 where 方法,根據提供的物件值篩選傳回的資料列。若至少傳回一筆記錄,即假設使用者具有提交訂單的必要權限故而執行插入作業,否則將傳回錯誤。

function insert(item, user, request) {
    var permissionsTable = tables.getTable('permissions');

    permissionsTable.where({
        userId: user.userId,
        permission: 'submit order'
    }).read({
        success: function(results) {
            if (results.length > 0) {
                // Permission record was found. Continue normal execution.
                request.execute();
            } else {
                console.log('User %s attempted to submit an order without permissions.', user.userId);
                request.respond(statusCodes.FORBIDDEN, 'You do not have permission to submit orders.');
            }
        }
    });
}

以下取自於排定工作的函式會執行 Transact-SQL 傳回重複的資料列,然後使用 del 方法移除重複項目。

function cleanup_channels() {
    var sql = "SELECT MAX(Id) as Id, Uri FROM Channel " + 
        "GROUP BY Uri HAVING COUNT(*) > 1";
    var channelTable = tables.getTable('Channel');

    mssql.query(sql, {
        success: function(results) {
            if (results.length > 0) {
                for (var i = 0; i < results.length; i++) {
                    channelTable.del(results[i].Id);
                    console.log('Deleted duplicate channel:' + 
                    results[i].Uri);
                }
            } else {
                console.log('No duplicate rows found.');
            }
        }
    });
}

Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2014 Microsoft