RoleProvider Classe

Definição

Define o contrato que o ASP.NET implementa para fornecer serviços de gerenciamento de função usando provedores de função personalizada.Defines the contract that ASP.NET implements to provide role-management services using custom role providers.

public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class RoleProvider : System.Configuration.Provider.ProviderBase
type RoleProvider = class
    inherit ProviderBase
Public MustInherit Class RoleProvider
Inherits ProviderBase
Herança
RoleProvider
Derivado

Comentários

O gerenciamento de função ASP.NET foi projetado para permitir que você use facilmente vários provedores de função diferentes para seus aplicativos ASP.NET.ASP.NET role management is designed to enable you to easily use a number of different role providers for your ASP.NET applications. Você pode usar os provedores de função fornecidos com o .NET Framework ou pode implementar seu próprio provedor.You can use the supplied role providers that are included with the .NET Framework, or you can implement your own provider.

Ao implementar um provedor de função personalizado, você precisa herdar a RoleProvider classe abstrata.When implementing a custom role provider, you are required to inherit the RoleProvider abstract class.

Há dois motivos principais para criar um provedor de função personalizado.There are two primary reasons for creating a custom role provider.

  • Você precisa armazenar informações de função em uma fonte de dados que não seja suportada pelos provedores de função incluídos com o .NET Framework, como um banco de dados do FoxPro, um Oracle Database ou outras fontes.You need to store role information in a data source that is not supported by the role providers included with the .NET Framework, such as a FoxPro database, an Oracle database, or other data sources.

  • Você precisa gerenciar informações de função usando um esquema de banco de dados diferente do esquema de banco de dados usado pelos provedores fornecidos com o .NET Framework.You need to manage role information using a database schema that is different from the database schema used by the providers that ship with the .NET Framework. Um exemplo comum disso seria os dados de função que já existem em um banco de dado SQL Server para uma empresa ou um site da Web.A common example of this would be role data that already exists in a SQL Server database for a company or Web site.

Construtores

RoleProvider()

Inicializa uma nova instância da classe RoleProvider.Initializes a new instance of the RoleProvider class.

Propriedades

ApplicationName

Obtém ou define o nome do aplicativo no qual as informações de função serão armazenadas e recuperadas.Gets or sets the name of the application to store and retrieve role information for.

Description

Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Herdado de ProviderBase)
Name

Obtém o nome amigável usado para referir-se ao provedor durante a configuração.Gets the friendly name used to refer to the provider during configuration.

(Herdado de ProviderBase)

Métodos

AddUsersToRoles(String[], String[])

Adiciona os nomes de usuário especificados às funções especificadas para o applicationName configurado.Adds the specified user names to the specified roles for the configured applicationName.

CreateRole(String)

Adiciona uma nova função à fonte de dados da applicationName configurada.Adds a new role to the data source for the configured applicationName.

DeleteRole(String, Boolean)

Remove uma nova função da fonte de dados da applicationName configurada.Removes a role from the data source for the configured applicationName.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FindUsersInRole(String, String)

Obtém uma matriz de nomes de usuário em uma função em que o nome de usuário contém o nome de usuário especificado para corresponder.Gets an array of user names in a role where the user name contains the specified user name to match.

GetAllRoles()

Obtém uma lista de todas as funções do applicationName configurado.Gets a list of all the roles for the configured applicationName.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRolesForUser(String)

Obtém uma lista das funções na qual o usuário especificado está para o applicationName configurado.Gets a list of the roles that a specified user is in for the configured applicationName.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUsersInRole(String)

Obtém uma lista de usuários na função especificada para o applicationName configurado.Gets a list of users in the specified role for the configured applicationName.

Initialize(String, NameValueCollection)

Inicializa o construtor de configuração.Initializes the configuration builder.

(Herdado de ProviderBase)
IsUserInRole(String, String)

Obtém um valor que indica se o usuário especificado está na função especificada para o applicationName configurado.Gets a value indicating whether the specified user is in the specified role for the configured applicationName.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
RemoveUsersFromRoles(String[], String[])

Remove os nomes de usuário especificados das funções especificadas para o applicationName configurado.Removes the specified user names from the specified roles for the configured applicationName.

RoleExists(String)

Obtém um valor que indica se o nome da função especificada já existe na fonte de dados de função para o applicationName configurado.Gets a value indicating whether the specified role name already exists in the role data source for the configured applicationName.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também