如何：使用 AND、OR、( 和 ) 运算符向访问群体添加复杂规则

上次修改时间： 2010年1月27日

适用范围： SharePoint Server 2010

用户界面只提供了两个选项供您为访问群体定义规则：包含满足所有规则的用户或包含满足任何规则的用户。尽管这对于一些场合可能已经足够，但您经常需要包含满足复杂规则的用户。复杂规则同时使用 AND 和 OR 运算符，它们还可以使用括号 ( ) 来对规则进行分组，以给予规则不同的含义。

在需要创建复杂规则的情况下，可以使用访问群体对象模型。此对象模型最多支持对括号进行三层嵌套。

下面的代码示例将为称作"John and Joe Connection"的访问群体添加复杂规则。此示例使用 AND、OR 以及 ( 和 ) 运算符来组合多个规则和对规则进行分组。

备注

如果使用复杂规则创建访问群体，您无法通过用户界面查看或编辑此访问群体的属性或删除此访问群体。但是，可以使用用户界面以查看其成员身份。

在运行代码示例之前，将服务器名称和其他字符串替换为实际值。此外，在 Microsoft Visual Studio 项目中添加以下引用：

• Microsoft.Office.Server

• Microsoft.Office.Server.UserProfiles

• Microsoft.SharePoint

• System.Web

示例

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint.Administration;
using Microsoft.Office.Server.Audience;
using Microsoft.SharePoint;
using Microsoft.Office.Server;
using System.Web;
using System.Collections;

namespace AudienceConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                using (SPSite site = new SPSite("https://servername"))
                {
                    SPServiceContext context = SPServiceContext.GetContext(site);
                    AudienceManager AudMgr = new AudienceManager(context);

                    AudienceCollection ac = AudMgr.Audiences;
                    Audience a = null;
                    bool ruleListNotEmpty = false;

                    try
                    {
                        a = AudMgr.Audiences["John and Joe Connection"];
                    }
                    catch (AudienceArgumentException ex)
                    {
                        //your exception handling code here
                    }

                    ArrayList aRules = a.AudienceRules;
                    if (aRules == null)
                    {
                        aRules = new ArrayList();
                    }
                    else
                    {
                        ruleListNotEmpty = true;
                    }


                    try
                    {
                        //if the rule is not emply, start with a group operator 'AND' to append
                        if (ruleListNotEmpty)
                        {
                            aRules.Add(new AudienceRuleComponent(null, "AND", null));
                        }

                        AudienceRuleComponent r0 = new AudienceRuleComponent(null, "(", null);
                        aRules.Add(r0);

                        AudienceRuleComponent r1 = new AudienceRuleComponent("FirstName", "Contains", "John");
                        aRules.Add(r1);

                        AudienceRuleComponent r2 = new AudienceRuleComponent(null, "AND", null);
                        aRules.Add(r2);

                        AudienceRuleComponent r3 = new AudienceRuleComponent("WorkEmail", "Contains", "example.com");
                        aRules.Add(r3);

                        AudienceRuleComponent r4 = new AudienceRuleComponent(null, ")", null);
                        aRules.Add(r4);

                        AudienceRuleComponent r5 = new AudienceRuleComponent(null, "OR", null);
                        aRules.Add(r5);

                        AudienceRuleComponent r6 = new AudienceRuleComponent(null, "(", null);
                        aRules.Add(r6);

                        AudienceRuleComponent r7 = new AudienceRuleComponent("FirstName", "Contains", "Joe");
                        aRules.Add(r7);

                        AudienceRuleComponent r8 = new AudienceRuleComponent(null, "AND", null);
                        aRules.Add(r8);

                        AudienceRuleComponent r9 = new AudienceRuleComponent("WorkEmail", "Contains", "someexample.com");
                        aRules.Add(r9);

                        AudienceRuleComponent r10 = new AudienceRuleComponent(null, ")", null);
                        aRules.Add(r10);
                        a.AudienceRules = aRules;
                        a.Commit();
                    }
                    catch (AudienceException e)
                    {
                        //Your exception handling code here
                    }
                }
            }

            catch (Exception exception)
            {
                Console.WriteLine(exception.ToString());
                Console.Read();
            }

        }

    }
}

请参阅

其他资源

使用访问群体设定内容