首页 > 代码库 > Sharepoint Resource Threshold
Sharepoint Resource Threshold
一个系统的界限称为阀,其数值称为阀值。
sharepoint中每个application都有一个资源阀值,对特定的资源进行限制(List view, List view Lookup,List Unique Permissions),要求各个系统都遵守这些约束来设计。
从而保证服务器的资源不会枯竭,保证各个站点正常的运行。一般情况下不要去改动阀值的设置,如果遇到问题,应该去改进系统的设计。
当超过application限制时,会出现以下错误:
The attempted operation is prohibited because it exceeds the list view threshold enforced by the administrator.
- 阀值配置
- List View Threshold:在一次查询中,最多能返回的Items数。
这里有2种情况都会执行失败:List中的Item总数超过阀值和返回满足查询条件的Item超过阀值
Case 1 :List中2001条数据,我们的查询要返回所有的数据,由于2001>2000(默认阀值),导致执行失败
Case 2: List中有2500条数据,满足查询条件的为1条,如果这条数据在2000之后的位置,就会执行失败
针对第二种情况,我们只要在List中建立索引即可。
针对第一种情况,我们可以使用SPQuery/SPSiteDataQuery的ListItemCollectionPosition属性来进行分页循环查询
实例代码如下:
SPList list = web.Lists[List_Name]; SPQuery query = new SPQuery(); query.RowLimit = itemThreshold; query.Query = @"<Query> <OrderBy> <FieldRef Name=‘ID‘ /> </OrderBy> </Query>"; query.ViewFields = @"<FieldRef Name=‘ID‘/> <FieldRef Name=‘Title‘/> <FieldRef Name=‘Created‘/>"; int intIndex = 1; do { SPListItemCollection collListItems = list.GetItems(query); foreach (SPListItem oListItem in collListItems) { allItems.Add(new objEntity { objId = int.Parse(oListItem["ID"].ToString()), objCreated = DateTime.Parse(oListItem["Created"].ToString()), objTitle = oListItem["Title"].ToString() }); } query.ListItemCollectionPosition = collListItems.ListItemCollectionPosition; intIndex++; } while (query.ListItemCollectionPosition != null);
上面的实例可以解决在查询过程中超过List Item阀值的问题。
- Object Model Override
List View Threshold是针对于普通用户的限制,系统管理员可以通过重写来使得可阀值变大(5000)
query.QueryThrottleMode = SPQueryThrottleOption.Override;
- List View Lookup Threshold
我们在设计List的时候,难免会有一些Lookup字段,通过lookup与其他的List进行关联,List中Lookup类型的字段不能超过这个阀值。
备注:以下的类型都是属于Lookup类型
Standard lookup columns,
single-value managed metadata,
multiple-value managed metadata,
single-value people and group columns,
multiple- value people and group columns
Workflow Status,
Created by ,
Modified by ( people)
总结:本节了解了sharepoint中对一些资源的限制规则,通过对这些限制的了解,来规范我们系统的设计。
Sharepoint Resource Threshold