.NET Framework 类库
RoleProvider.AddUsersToRoles 方法

注意:此方法在 .NET Framework 2.0 版中是新增的。

将指定用户名添加到已配置的 applicationName 的指定角色名。

命名空间:System.Web.Security
程序集:System.Web(在 system.web.dll 中)

语法

Visual Basic(声明)
Public MustOverride Sub AddUsersToRoles ( _
    usernames As String(), _
    roleNames As String() _
)
Visual Basic(用法)
Dim instance As RoleProvider
Dim usernames As String()
Dim roleNames As String()

instance.AddUsersToRoles(usernames, roleNames)
C#
public abstract void AddUsersToRoles (
    string[] usernames,
    string[] roleNames
)
C++
public:
virtual void AddUsersToRoles (
    array<String^>^ usernames, 
    array<String^>^ roleNames
) abstract
J#
public abstract void AddUsersToRoles (
    String[] usernames, 
    String[] roleNames
)
JScript
public abstract function AddUsersToRoles (
    usernames : String[], 
    roleNames : String[]
)

参数

usernames

一个字符串数组,其中包含要添加到指定角色的用户名。

roleNames

一个字符串数组,其中包含要将指定用户名添加到的角色的名称。

备注

AddUsersToRolesRoles 类调用,以使指定用户与数据源中的指定角色相关联。角色会被添加到已配置的 ApplicationName

如果没有为已配置的 applicationName 找到任何指定的 roleNames,则建议提供程序引发 ProviderException

如果任何指定的 usernames 都不与已配置的 applicationName 的任何指定 roleNames 相关联,则建议提供程序引发 ProviderException

如果任何指定的 usernames 为 空引用(在 Visual Basic 中为 Nothing) 或是空字符串,建议提供程序引发异常。

如果任何指定的 roleNames 为 空引用(在 Visual Basic 中为 Nothing) 或是空字符串,建议提供程序引发异常。

如果数据源支持事务,则建议将每个添加操作包含在一个事务中,如果有任何添加操作出现失败,则回滚事务并引发异常。

示例

下面的代码示例演示 AddUsersToRoles 方法的示例实现。

Visual Basic
Public Overrides Sub AddUsersToRoles(usernames As String(), rolenames As String()) 

  For Each rolename As String In rolenames
    If rolename Is Nothing OrElse rolename = "" Then _
      Throw New ProviderException("Role name cannot be empty or null.")
    If Not RoleExists(rolename) Then _
      Throw New ProviderException("Role name not found.")
  Next

  For Each username As String in usernames
    If username Is Nothing OrElse username = "" Then _
      Throw New ProviderException("User name cannot be empty or null.")
    If username.IndexOf(",") > 0 Then _
      Throw New ArgumentException("User names cannot contain commas.")

    For Each rolename As String In rolenames
      If IsUserInRole(username, rolename) Then
        Throw New ProviderException("User is already in role.")
      End If
    Next
  Next


  Dim conn As OdbcConnection = New OdbcConnection(connectionString)
  Dim cmd As OdbcCommand = New OdbcCommand("INSERT INTO [" & usersInRolesTable & "]" & _
                                           " (Username, Rolename, ApplicationName) " & _
                                           " Values(?, ?, ?)", conn)

  Dim userParm As OdbcParameter = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255)
  Dim roleParm As OdbcParameter = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255)
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName

  Try
    conn.Open()

    For Each username As String In usernames
      For Each rolename As String In rolenames
        userParm.Value = username
        roleParm.Value = rolename
        cmd.ExecuteNonQuery()
      Next
    Next
  Catch e As OdbcException
    ' Handle exception.
  Finally
    conn.Close()      
  End Try
End Sub
C#
public override void AddUsersToRoles(string[]  usernames, string[] rolenames)
{
  foreach (string rolename in rolenames)
  {
    if (rolename == null || rolename == "")
      throw new ProviderException("Role name cannot be empty or null.");
    if (!RoleExists(rolename))
      throw new ProviderException("Role name not found.");
  }

  foreach (string username in usernames)
  {
    if (username == null || username == "")
      throw new ProviderException("User name cannot be empty or null.");
    if (username.IndexOf(',') > 0)
      throw new ArgumentException("User names cannot contain commas.");

    foreach (string rolename in rolenames)
    {
      if (IsUserInRole(username, rolename))
        throw new ProviderException("User is already in role.");
    }
  }


  OdbcConnection conn = new OdbcConnection(connectionString);
  OdbcCommand cmd = new OdbcCommand("INSERT INTO [" + usersInRolesTable + "]"  +
                                    " (Username, Rolename, ApplicationName) " +
                                    " Values(?, ?, ?)", conn);

  OdbcParameter userParm = cmd.Parameters.Add("@Username", OdbcType.VarChar, 255);
  OdbcParameter roleParm = cmd.Parameters.Add("@Rolename", OdbcType.VarChar, 255);
  cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = ApplicationName;

  try
  {
    conn.Open();

    foreach (string username in usernames)
    {
      foreach (string rolename in rolenames)
      {
        userParm.Value = username;
        roleParm.Value = rolename;
        cmd.ExecuteNonQuery();
      }
    }
  }
  catch (OdbcException)
  {
    // Handle exception.
  }
  finally
  {
    conn.Close();      
  }
}
平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0
请参见

标记 :


Page view tracker