首页 > 代码库 > Sharepoint Resource Threshold

Sharepoint Resource Threshold

2024-07-29 01:46:46   222人阅读

一个系统的界限称为阀，其数值称为阀值。

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


联系
我们