SqlMembershipProvider Clase

Definición

Espacio de nombres:: System.Web.Security

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Administra el almacenamiento de información de pertenencia para una aplicación de 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: Object

ProviderBase

MembershipProvider
SqlMembershipProvider

Ejemplos

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

Note

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

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

Para crear manualmente la base de datos, ejecute el archivo ejecutable Aspnet_regsql.exe que se encuentra en la carpeta %systemroot%\Microsoft.NET\Framework\ versionNumber y especifique la opción -A m (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 gui y elija configurar todas las características de ASP.NET.

Si el proveedor de pertenencia está configurado con un 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 de 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 puede definir su propia instancia en el archivo Web.config para la aplicación de ASP.NET.

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

Constructores

Nombre	Description
SqlMembershipProvider()	Inicializa una nueva instancia de la clase SqlMembershipProvider.

Propiedades

Nombre	Description
ApplicationName	Obtiene o establece el nombre de la aplicación para el que se va a almacenar y recuperar la información de pertenencia.
Description	Obtiene una breve descripción fácil de mostrar en herramientas administrativas u otras interfaces de usuario (UIs). (Heredado de ProviderBase)
EnablePasswordReset	Obtiene un valor que indica si el proveedor de pertenencia a SQL Server está configurado para permitir que los usuarios restablezcan sus contraseñas.
EnablePasswordRetrieval	Obtiene un valor que indica si el proveedor de pertenencia a SQL Server está configurado para permitir que los usuarios recuperen sus contraseñas.
MaxInvalidPasswordAttempts	Obtiene el número de intentos de contraseña o respuesta de contraseña no válidos permitidos antes de que el usuario de pertenencia esté bloqueado.
MinRequiredNonAlphanumericCharacters	Obtiene el número mínimo de caracteres especiales que deben estar presentes en una contraseña válida.
MinRequiredPasswordLength	Obtiene la longitud mínima necesaria para una contraseña.
Name	Obtiene el nombre descriptivo que se usa para hacer referencia al proveedor durante la configuración. (Heredado de ProviderBase)
PasswordAttemptWindow	Obtiene el período de tiempo entre el que se realiza un seguimiento de los intentos fallidos consecutivos de proporcionar una contraseña o respuestas de contraseña válidas.
PasswordFormat	Obtiene un valor que indica el formato para almacenar contraseñas en la base de datos de pertenencia SQL Server.
PasswordStrengthRegularExpression	Obtiene la expresión regular usada para evaluar una contraseña.
RequiresQuestionAndAnswer	Obtiene un valor que indica si el proveedor de pertenencia a SQL Server está configurado para requerir al usuario que responda a una pregunta de contraseña para el restablecimiento y recuperación de contraseñas.
RequiresUniqueEmail	Obtiene un valor que indica si el proveedor de pertenencia SQL Server está configurado para requerir una dirección de correo electrónico única para cada nombre de usuario.

Métodos

Nombre	Description
ChangePassword(String, String, String)	Modifica la contraseña de un usuario.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Actualiza la pregunta y respuesta de contraseña para un usuario de 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[], MembershipPasswordCompatibilityMode)	Cifra la contraseña especificada mediante el modo de compatibilidad con contraseña especificado. (Heredado de MembershipProvider)
EncryptPassword(Byte[])	Cifra una contraseña. (Heredado de MembershipProvider)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Devuelve una colección de usuarios de pertenencia para los que el campo 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 que debe coincidir.
GeneratePassword()	Genera una contraseña aleatoria que tiene al menos 14 caracteres de longitud.
GetAllUsers(Int32, Int32, Int32)	Obtiene una colección de todos los usuarios de la base de datos de pertenencia a SQL Server.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetNumberOfUsersOnline()	Devuelve el número de usuarios que acceden actualmente a la aplicación.
GetPassword(String, String)	Devuelve la contraseña del 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 del usuario de pertenencia asociado al identificador único especificado y actualiza la marca de fecha y hora de la última actividad para el usuario, si se especifica.
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 para el usuario.
GetUserNameByEmail(String)	Obtiene el nombre de usuario asociado a la dirección de correo electrónico especificada.
Initialize(String, NameValueCollection)	Inicializa el proveedor de pertenencia SQL Server con los valores de propiedad especificados en el archivo de configuración de la aplicación ASP.NET. Este método no está pensado para usarse directamente desde el código.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Genera el ValidatingPassword evento 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 bloqueado 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 la contraseña especificados existen en la base de datos de pertenencia de SQL Server.

Eventos

Nombre	Description
ValidatingPassword	Se produce cuando se crea un usuario, se cambia una contraseña o se restablece una contraseña. (Heredado de MembershipProvider)

Se aplica a

Consulte también

Introducción a la pertenencia a ASP.NET

Comentarios

¿Le ha resultado útil esta página?