SqlMembershipProvider SqlMembershipProvider SqlMembershipProvider SqlMembershipProvider Class

Definición

Administra el almacenamiento de información de pertenencia para una aplicación ASP.NET en una base de datos de SQL Server.Manages storage of membership information for an ASP.NET application in a SQL Server database.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider
public class SqlMembershipProvider : System.Web.Security.MembershipProvider
type SqlMembershipProvider = class
    inherit MembershipProvider
Public Class SqlMembershipProvider
Inherits MembershipProvider
Herencia

Ejemplos

El ejemplo de código siguiente muestra el archivo Web.config para una aplicación ASP.NET configurada para usar un SqlMembershipProvider.The following code example shows the Web.config file for an ASP.NET application configured to use a SqlMembershipProvider.

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
  </connectionStrings>  
  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="login.aspx"  
        name=".ASPXFORMSAUTH" />  
    </authentication>  
    <authorization>  
      <deny users="?" />  
    </authorization>  
    <membership defaultProvider="SqlProvider"  
      userIsOnlineTimeWindow="15">  
      <providers>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Comentarios

Esta clase es utilizada por el Membership y MembershipUser las clases para proporcionar servicios de pertenencia para una aplicación ASP.NET con una base de datos de SQL Server.This class is used by the Membership and MembershipUser classes to provide membership services for an ASP.NET application using a SQL Server database. No puede usar un SqlMembershipProvider sin SQL Server.You cannot use a SqlMembershipProvider without SQL Server. Cuando el equipo tiene SQL Server Express instalada con el nombre de instancia predeterminado y el usuario-creación de instancias está habilitada, el SqlMembershipProvider objeto creará una base de datos denominada aspnetdb en la aplicación App_Data directorio la primera vez la aplicación se ejecuta.When your computer has SQL Server Express installed with the default instance name and user-instancing enabled, the SqlMembershipProvider object will create a database called aspnetdb in the application's App_Data directory the first time the application is run.

Para crear manualmente la base de datos, ejecute el Aspnet_regsql.exe ejecutable se encuentra en la %systemroot%\Microsoft.NET\Framework\ versionNumber carpeta y especifique la -A m opción (por ejemplo aspnet_regsql.exe -A m).To manually create the database, run the Aspnet_regsql.exe executable found in the %systemroot%\Microsoft.NET\Framework\ versionNumber folder and specify the -A m option (for example aspnet_regsql.exe -A m). La base de datos creado se denomina Aspnetdb.The database created is called Aspnetdb. También puede ejecutar Aspnet_regsql.exe para extraer el modo de configuración de la interfaz gráfica de usuario y optar por configurar todas las características de ASP.NET.Alternatively, run Aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET Features.

Si el proveedor de pertenencia está configurado con una cadena de conexión que utiliza seguridad integrada, la cuenta de proceso de la aplicación ASP.NET debe tener derechos para conectarse a la base de datos de SQL Server.If the membership provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

El archivo Machine.config define el valor predeterminado es SqlMembershipProvider instancia denominada AspNetSqlMembershipProvider que se conecta a la instancia predeterminada de SQL Server Express en el equipo local.The Machine.config file defines a default SqlMembershipProvider instance named AspNetSqlMembershipProvider that connects to the default SQL Server Express instance on the local machine. Puede usar esta instancia del proveedor si instala SQL Server Express con el nombre de instancia predeterminado, o puede definir su propia instancia en el archivo Web.config de la aplicación ASP.NET.You can use this instance of the provider if you installed SQL Server Express with the default instance name, or you can define your own instance in the Web.config file for your ASP.NET application.

Si establece la passwordCompatMode atributo Framework40, la aplicación puede usar el hash y las opciones de pertenencia de cifrado que se agregaron en ASP.NET 4.If you set the passwordCompatMode attribute to Framework40, the application can use the hashing and encryption membership options that were added in ASP.NET 4. Sin embargo, si la passwordCompatMode atributo está establecido en Framework20, solo la pertenencia de cifrado y hash de opciones desde la versión 2.0 de ASP.NET, ASP.NET 3.5, y se puede usar ASP.NET 3.5 SP1.However, if the passwordCompatMode attribute is set to Framework20, only the hashing and encryption membership options from the ASP.NET 2.0, ASP.NET 3.5, and ASP.NET 3.5 SP1 can be used. El valor predeterminado es Framework20.The default value is Framework20. Para obtener más información, vea MembershipPasswordCompatibilityMode.For more information, see MembershipPasswordCompatibilityMode.

Constructores

SqlMembershipProvider() SqlMembershipProvider() SqlMembershipProvider() SqlMembershipProvider()

Inicializa una nueva instancia de la clase SqlMembershipProvider.Initializes a new instance of the SqlMembershipProvider class.

Propiedades

ApplicationName ApplicationName ApplicationName ApplicationName

Obtiene o establece el nombre de la aplicación para la que se va a almacenar y recuperar información de pertenencia.Gets or sets the name of the application to store and retrieve membership information for.

Description Description Description Description

Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
EnablePasswordReset EnablePasswordReset EnablePasswordReset EnablePasswordReset

Obtiene un valor que indica si el proveedor de pertenencia de SQL Server se configura para permitir a los usuarios restablecer sus contraseñas.Gets a value indicating whether the SQL Server membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval

Obtiene un valor que indica si el proveedor de pertenencia de SQL Server se configura para permitir a los usuarios recuperar sus contraseñas.Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts

Obtiene el número de intentos de contraseña no válida o de respuesta a la contraseña incorrecta permitidos antes de bloquear al usuario de pertenencia.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters

Obtiene el número mínimo de caracteres especiales que deben estar presentes en una contraseña válida.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength

Obtiene la longitud mínima necesaria para una contraseña.Gets the minimum length required for a password.

Name Name Name Name

Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)
PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow

Obtiene la ventana de tiempo durante el que se realiza un seguimiento de los intentos incorrectos consecutivos para proporcionar una contraseña o respuestas de contraseña válidas.Gets the time window between which consecutive failed attempts to provide a valid password or password answers are tracked.

PasswordFormat PasswordFormat PasswordFormat PasswordFormat

Obtiene un valor que indica el formato para almacenar las contraseñas en la base de datos de pertenencia de SQL Server.Gets a value indicating the format for storing passwords in the SQL Server membership database.

PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression

Obtiene la expresión regular utilizada para evaluar una contraseña.Gets the regular expression used to evaluate a password.

RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer

Obtiene un valor que indica si el proveedor de pertenencia de SQL Server está configurado para exigir al usuario que responda una pregunta de contraseña para el restablecimiento y recuperación de la contraseña.Gets a value indicating whether the SQL Server membership provider is configured to require the user to answer a password question for password reset and retrieval.

RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail

Obtiene un valor que indica si el proveedor de pertenencia de SQL Server se ha configurado para exigir una dirección de correo electrónico única por cada nombre de usuario.Gets a value indicating whether the SQL Server membership provider is configured to require a unique email address for each user name.

Métodos

ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String)

Modifica la contraseña de un usuario.Modifies a user's password.

ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String)

Actualiza la pregunta y respuesta de la contraseña para un usuario en la base de datos de pertenencia de SQL Server.Updates the password question and answer for a user in the SQL Server membership database.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Agrega un nuevo usuario a la base de datos de pertenencia de SQL Server.Adds a new user to the SQL Server membership database.

DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[])

Descifra una contraseña cifrada.Decrypts an encrypted password.

(Inherited from MembershipProvider)
DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean)

Quita la información de pertenencia de un usuario de la base de datos de pertenencia de SQL Server.Removes a user's membership information from the SQL Server membership database.

EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[])

Cifra una contraseña.Encrypts a password.

(Inherited from MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Cifra la contraseña especificada usando el modo de compatibilidad de contraseña especificado.Encrypts the specified password using the specified password-compatibility mode.

(Inherited from MembershipProvider)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32)

Devuelve una colección de usuarios de pertenencia para los que el campo de dirección de correo electrónico contiene la dirección de correo electrónico especificada.Returns a collection of membership users for which the email address field contains the specified email address.

FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32)

Obtiene una colección de usuarios de pertenencia donde el nombre de usuario contiene el nombre de usuario especificado para su coincidencia.Gets a collection of membership users where the user name contains the specified user name to match.

GeneratePassword() GeneratePassword() GeneratePassword() GeneratePassword()

Genera una contraseña aleatoria que tiene al menos 14 caracteres.Generates a random password that is at least 14 characters long.

GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32)

Obtiene una colección de todos los usuarios en la base de datos de pertenencia de SQL Server.Gets a collection of all the users in the SQL Server membership database.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline()

Devuelve el número de usuarios que actualmente tienen acceso a la aplicación.Returns the number of users currently accessing the application.

GetPassword(String, String) GetPassword(String, String) GetPassword(String, String) GetPassword(String, String)

Devuelve la contraseña para el nombre de usuario especificado de la base de datos de pertenencia de SQL Server.Returns the password for the specified user name from the SQL Server membership database.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean)

Obtiene la información del origen de datos para el usuario de pertenencia asociado al identificador único especificado y actualiza la marca de fecha y hora de última actividad para el usuario si se ha especificado.Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.

GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean)

Devuelve información de la base de datos de pertenencia de SQL Server para un usuario y proporciona una opción para actualizar la marca de fecha y hora de la última actividad del usuario.Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.

GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String)

Obtiene el nombre de usuario asociado con la dirección de correo electrónico especificada.Gets the user name associated with the specified email address.

Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Inicializa el proveedor de pertenencia de SQL Server con los valores de propiedades especificados en el archivo de configuración de la aplicación ASP.NET.Initializes the SQL Server membership provider with the property values specified in the ASP.NET application's configuration file. Este método no está pensado para usarse directamente desde su código.This method is not intended to be used directly from your code.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs)

Genera el evento ValidatingPassword si se ha definido un controlador de eventos.Raises the ValidatingPassword event if an event handler has been defined.

(Inherited from MembershipProvider)
ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String)

Restablece la contraseña de un usuario a una nueva generada automáticamente.Resets a user's password to a new, automatically generated password.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
UnlockUser(String) UnlockUser(String) UnlockUser(String) UnlockUser(String)

Borra el estado de bloqueo del usuario para que se pueda validar el usuario de pertenencia.Clears the user's locked-out status so that the membership user can be validated.

UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser)

Actualiza información sobre un usuario en la base de datos de pertenencia de SQL Server.Updates information about a user in the SQL Server membership database.

ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String)

Comprueba que el nombre de usuario y contraseña especificados existen en la base de datos de pertenencia de SQL Server.Verifies that the specified user name and password exist in the SQL Server membership database.

Eventos

ValidatingPassword ValidatingPassword ValidatingPassword ValidatingPassword

Se produce cuando se crea un usuario, o cuando se cambia o se restablece una contraseña.Occurs when a user is created, a password is changed, or a password is reset.

(Inherited from MembershipProvider)

Se aplica a

Consulte también: