SqlMembershipProvider Clase

Definición

Administra el almacenamiento de información de pertenencia para una aplicación ASP.NET en una base de datos de SQL Server.

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
SqlMembershipProvider

Ejemplos

En el ejemplo de código siguiente se muestra el archivo Web.config para una aplicación de ASP.NET configurada para usar .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

Nota

ASP.NET proveedores de pertenencia se han reemplazado por ASP.NET Identity. Se recomienda encarecidamente actualizar las aplicaciones para usar la plataforma de identidad de ASP.NET en lugar de los proveedores de pertenencia.

Las clases y MembershipUser usan Membership esta clase para proporcionar servicios de pertenencia para una aplicación de ASP.NET mediante una base de datos de SQL Server. No se puede usar sin SqlMembershipProvider SQL Server. Cuando el equipo tiene SQL Server Express instalado con el nombre de instancia predeterminado y la instancia de usuario habilitada, el SqlMembershipProvider objeto creará una base de datos denominada aspnetdb en el directorio de App_Data la aplicación la primera vez que se ejecuta la aplicación.

Para crear manualmente la base de datos, ejecute el Aspnet_regsql.exe archivo ejecutable que se encuentra en la %systemroot%\Microsoft.NET\Framework\ versionNumber carpeta y especifique la -A m opción (por ejemplo aspnet_regsql.exe -A m, ). La base de datos creada se denomina Aspnetdb. Como alternativa, ejecute Aspnet_regsql.exe para extraer el modo de configuración de la GUI y elija configurar todas las características de ASP.NET.

Si el proveedor de pertenencia está configurado con una cadena de conexión que usa la seguridad integrada, la cuenta de proceso de la aplicación de ASP.NET debe tener derechos para conectarse a la base de datos de SQL Server.

El archivo Machine.config define una instancia predeterminada SqlMembershipProvider denominada AspNetSqlMembershipProvider que se conecta a la instancia predeterminada de SQL Server Express en el equipo local. Puede usar esta instancia del proveedor si instaló SQL Server Express con el nombre de instancia predeterminado, o bien puede definir su propia instancia en el archivo Web.config para la aplicación de ASP.NET.

Si establece el passwordCompatMode atributo Framework40en , la aplicación puede usar las opciones de pertenencia a hash y cifrado que se agregaron en ASP.NET 4. Sin embargo, si el passwordCompatMode atributo se establece Framework20en , solo se pueden usar las opciones de pertenencia a hash y cifrado de la ASP.NET 2.0, ASP.NET 3.5 y ASP.NET 3.5 SP1. El valor predeterminado es Framework20. Para obtener más información, vea MembershipPasswordCompatibilityMode.

Constructores

SqlMembershipProvider()

Inicializa una nueva instancia de la clase SqlMembershipProvider.

Propiedades

ApplicationName

Obtiene o establece el nombre de la aplicación para la que se va a almacenar y recuperar información de pertenencia.

Description

Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario.

(Heredado de ProviderBase)
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.

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.

MaxInvalidPasswordAttempts

Obtiene el número de intentos de contraseña o respuesta de contraseña no válidos que se permiten antes de bloquear al usuario de pertenencia.

MinRequiredNonAlphanumericCharacters

Obtiene el número mínimo de caracteres especiales que debe contener una contraseña válida.

MinRequiredPasswordLength

Obtiene la longitud mínima necesaria para una contraseña.

Name

Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración.

(Heredado de ProviderBase)
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.

PasswordFormat

Obtiene un valor que indica el formato para almacenar las contraseñas en la base de datos de pertenencia de SQL Server.

PasswordStrengthRegularExpression

Obtiene la expresión regular utilizada para evaluar una contraseña.

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.

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.

Métodos

ChangePassword(String, String, String)

Modifica la contraseña de un usuario.

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.

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

Agrega un nuevo usuario a la base de datos de pertenencia de SQL Server.

DecryptPassword(Byte[])

Descifra una contraseña cifrada.

(Heredado de MembershipProvider)
DeleteUser(String, Boolean)

Quita la información de pertenencia de un usuario de la base de datos de pertenencia de SQL Server.

EncryptPassword(Byte[])

Cifra una contraseña.

(Heredado de MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Cifra la contraseña especificada usando el modo de compatibilidad de contraseña especificado.

(Heredado de MembershipProvider)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
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.

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.

GeneratePassword()

Genera una contraseña aleatoria que tiene al menos 14 caracteres.

GetAllUsers(Int32, Int32, Int32)

Obtiene una colección de todos los usuarios en la base de datos de pertenencia de SQL Server.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetNumberOfUsersOnline()

Devuelve el número de usuarios que actualmente tienen acceso a la aplicación.

GetPassword(String, String)

Devuelve la contraseña para el nombre de usuario especificado de la base de datos de pertenencia de SQL Server.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
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.

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.

GetUserNameByEmail(String)

Obtiene el nombre de usuario asociado con la dirección de correo electrónico especificada.

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. Este método no está pensado para usarse directamente desde su código.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Genera el evento ValidatingPassword si se ha definido un controlador de eventos.

(Heredado de MembershipProvider)
ResetPassword(String, String)

Restablece la contraseña de un usuario a una nueva contraseña generada automáticamente.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
UnlockUser(String)

Borra el estado de bloqueo del usuario para que se pueda validar el usuario de pertenencia.

UpdateUser(MembershipUser)

Actualiza información sobre un usuario en la base de datos de pertenencia de SQL Server.

ValidateUser(String, String)

Comprueba que el nombre de usuario y contraseña especificados existen en la base de datos de pertenencia de SQL Server.

Eventos

ValidatingPassword

Se produce cuando se crea un usuario o se cambia o se restablece una contraseña.

(Heredado de MembershipProvider)

Se aplica a

Consulte también