User.IsUserMemberOf(String) 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

获取一个值，指示当前用户是否为指定组的成员。

public:
 abstract bool IsUserMemberOf(System::String ^ groupName);

public abstract bool IsUserMemberOf (string groupName);

abstract member IsUserMemberOf : string -> bool

Public MustOverride Function IsUserMemberOf (groupName As String) As Boolean

参数

groupName

String

组名称的格式为 domain\groupname。

返回

Boolean

如果当前用户是指定组的成员，则返回 true，否则返回 false。

例外

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

在下面的示例中，单击“按钮”控件将显示一个值，指示当前用户是否是指定组的成员。

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   MessageBox.Show(
      this.Application.User.IsUserMemberOf(
      "CONTOSO\\Users").ToString());
}

Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   MessageBox.Show( _
      Me.Application.User.IsUserMemberOf("CONTOSO\\Users").ToString())
End Sub

注解

即使方法 IsUserMemberOf(String) 标记为安全级别 2，也并非始终可访问。 调用IsUserMemberOf(String)方法时，InfoPath 首先执行安全检查以确定是否允许访问此方法。 安全检查可确认调用代码是否可信，并确定调用代码的位置。

如果调用代码 (受信任，例如， IsUserMemberOf(String) 从已安装或签名的 InfoPath 表单模板或受信任的外部代码（如本地计算机上的可执行文件) ）调用方法，则 InfoPath 将允许对 方法的完全访问权限 IsUserMemberOf(String) 。

如果调用代码不可信（例如调用来自基于域的 InfoPath 表单模板时），InfoPath 将首先检查调用的来源。 如果调用来自 InfoPath 表单模板中不受信任的 URL（如“”http://www.contoso.com/example.xsn）的代码，则调用来自 Internet 区域。 对于来自 Internet 区域的所有不受信任的调用，InfoPath 将拒绝访问 IsUserMemberOf(String) 方法。 如果调用来自 URL（如“”http://contoso/example.xsn），则调用来自 Intranet 区域。 对于来自 Intranet 区域的不可信的调用，InfoPath 会检查 Internet Explorer 用户身份验证设置是否允许自动登录（仅限于 Intranet 区域，或者对于每次登录的情况）。 如果将 Internet Explorer 配置为自动登录，则 InfoPath 将检查用户的组成员身份。 如果组成员身份是公共的，则 InfoPath 允许对 IsUserMemberOf(String) 方法进行完全访问。 如果组成员身份不是完全公开的，则 InfoPath 将隐藏结果。 也就是说，InfoPath 将组成员身份视为不可见。 在这种情况下，由于组成员身份是不公开的，因此返回值始终为 false。 InfoPath 不会对拒绝访问进行报告。

注意：如果允许访问组成员身份信息，并且所有非匿名用户都可以看到该信息，则组成员身份信息是完全公开的。 即使特别指定只有一个非匿名的用户无权访问组成员身份信息，该信息也不是完全公开的。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。