RoleProvider.RemoveUsersFromRoles(String[], String[]) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Remove os nomes de utilizador especificados dos papéis especificados para o .applicationName
public:
abstract void RemoveUsersFromRoles(cli::array <System::String ^> ^ usernames, cli::array <System::String ^> ^ roleNames);
public abstract void RemoveUsersFromRoles(string[] usernames, string[] roleNames);
abstract member RemoveUsersFromRoles : string[] * string[] -> unit
Public MustOverride Sub RemoveUsersFromRoles (usernames As String(), roleNames As String())
Parâmetros
- usernames
- String[]
Um conjunto de nomes de utilizador a remover dos papéis especificados.
- roleNames
- String[]
Um conjunto de nomes de papéis para remover os nomes de utilizador especificados.
Exemplos
O exemplo de código seguinte mostra uma implementação exemplar do RemoveUsersFromRoles método.
public override void RemoveUsersFromRoles(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.");
foreach (string rolename in rolenames)
{
if (!IsUserInRole(username, rolename))
throw new ProviderException("User is not in role.");
}
}
OdbcConnection conn = new OdbcConnection(connectionString);
OdbcCommand cmd = new OdbcCommand("DELETE FROM UsersInRoles " +
" WHERE Username = ? AND Rolename = ? AND ApplicationName = ?", 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();
}
}
Public Overrides Sub RemoveUsersFromRoles(ByVal usernames As String(), ByVal 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.")
For Each rolename As String In rolenames
If Not IsUserInRole(username, rolename) Then
Throw New ProviderException("User is not in role.")
End If
Next
Next
Dim conn As OdbcConnection = New OdbcConnection(connectionString)
Dim cmd As OdbcCommand = New OdbcCommand("DELETE FROM UsersInRoles " & _
" WHERE Username = ? AND Rolename = ? AND ApplicationName = ?", 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
Observações
RemoveUsersFromRoles é chamada por RemoveUserFromRole , RemoveUsersFromRole , RemoveUserFromRoles , e RemoveUsersFromRoles métodos da Roles classe para remover os utilizadores especificados dos papéis especificados na fonte de dados. Apenas os papéis para os configurados ApplicationName são modificados.
Se nenhum dos nomes de papéis especificados for encontrado para a configuração applicationName, recomendamos que o seu fornecedor lance um ProviderExceptionarquivo .
Se algum dos nomes de utilizador especificados não estiver associado a nenhum dos nomes de papéis especificados para o configurado applicationName, recomendamos que o seu fornecedor faça um ProviderExceptionarquivo .
Se algum dos nomes de utilizador especificados for null ou for uma cadeia vazia, recomendamos que o seu fornecedor faça uma exceção.
Se algum dos nomes de funções especificados for null ou for uma cadeia vazia, recomendamos que o seu fornecedor faça uma exceção.
Se a sua fonte de dados suportar transações, recomendamos que inclua cada operação de remoção numa transação e que reverta a transação e lance uma exceção caso alguma operação de remoção falhe.