RoleProvider Classe
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.
Define o contrato que o ASP.NET implementa para fornecer serviços de gestão de funções utilizando fornecedores de funções personalizados.
public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class RoleProvider : System.Configuration.Provider.ProviderBasetype RoleProvider = class
inherit ProviderBasePublic MustInherit Class RoleProvider
Inherits ProviderBase- Herança
- Derivado
Observações
A gestão de funções ASP.NET foi concebida para lhe permitir utilizar facilmente vários fornecedores de funções diferentes para as suas aplicações ASP.NET. Pode usar os fornecedores de funções fornecidos que vêm incluídos no .NET Framework, ou pode implementar o seu próprio fornecedor.
Ao implementar um fornecedor de funções personalizado, é obrigado a herdar a RoleProvider classe abstrata.
Existem duas razões principais para criar um fornecedor de funções personalizadas.
É necessário armazenar informação de função numa fonte de dados que não seja suportada pelos fornecedores de funções incluídos no .NET Framework, como uma base de dados FoxPro, uma base de dados Oracle ou outras fontes de dados.
É necessário gerir a informação dos papéis usando um esquema de base de dados diferente do esquema de base de dados usado pelos fornecedores que vêm com o .NET Framework. Um exemplo comum disto seriam dados de funções que já existem numa base de dados SQL Server para uma empresa ou site.
Construtores
| Name | Description |
|---|---|
| RoleProvider() |
Inicializa uma nova instância da RoleProvider classe. |
Propriedades
| Name | Description |
|---|---|
| ApplicationName |
Obtém ou define o nome da aplicação para armazenar e recuperar a informação do papel. |
| Description |
Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs). (Herdado de ProviderBase) |
| Name |
Recebe o nome amigável usado para se referir ao fornecedor durante a configuração. (Herdado de ProviderBase) |
Métodos
| Name | Description |
|---|---|
| AddUsersToRoles(String[], String[]) |
Adiciona os nomes de utilizador especificados aos papéis especificados para o . |
| CreateRole(String) |
Adiciona um novo papel à fonte de dados para o . |
| DeleteRole(String, Boolean) |
Remove um papel da fonte de dados para o . |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindUsersInRole(String, String) |
Obtém um array de nomes de utilizador num papel onde o nome de utilizador contém o nome de utilizador especificado para corresponder. |
| GetAllRoles() |
Obtém uma lista de todos os papéis para o . |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetRolesForUser(String) |
Obtém uma lista dos papéis em que um utilizador especificado está para o . |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUsersInRole(String) |
Obtém uma lista de utilizadores no papel especificado para o . |
| Initialize(String, NameValueCollection) |
Inicializa o construtor de configuração. (Herdado de ProviderBase) |
| IsUserInRole(String, String) |
Obtém um valor que indica se o utilizador especificado está no papel especificado para o . |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| RemoveUsersFromRoles(String[], String[]) |
Remove os nomes de utilizador especificados dos papéis especificados para o . |
| RoleExists(String) |
Obtém um valor que indica se o nome do papel especificado já existe na fonte de dados do papel para o . |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |