首页 > 代码库 > 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/SPSiteDataQueryListItemCollectionPosition属性来进行分页循环查询

实例代码如下:

                    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