MembershipUser Construtores

Definição

Cria um novo objeto de usuário associado com os valores da propriedade especificados.

Sobrecargas

MembershipUser()

Cria uma nova instância de um objeto MembershipUser para uma classe que herda a classe MembershipUser.

MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Cria um novo objeto de usuário associado com os valores da propriedade especificados.

MembershipUser()

Cria uma nova instância de um objeto MembershipUser para uma classe que herda a classe MembershipUser.

protected MembershipUser ();

Comentários

O MembershipUser construtor não se destina a ser usado do seu código.

Confira também

Aplica-se a

MembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)

Cria um novo objeto de usuário associado com os valores da propriedade especificados.

public MembershipUser (string providerName, string name, object providerUserKey, string email, string passwordQuestion, string comment, bool isApproved, bool isLockedOut, DateTime creationDate, DateTime lastLoginDate, DateTime lastActivityDate, DateTime lastPasswordChangedDate, DateTime lastLockoutDate);

Parâmetros

providerName
String

A cadeia de caracteres ProviderName do usuário associado.

name
String

A cadeia de caracteres UserName do usuário associado.

providerUserKey
Object

O identificador ProviderUserKey do usuário associado.

email
String

A cadeia de caracteres Email do usuário associado.

passwordQuestion
String

A cadeia de caracteres PasswordQuestion do usuário associado.

comment
String

A cadeia de caracteres Comment do usuário associado.

isApproved
Boolean

O valor IsApproved do usuário associado.

isLockedOut
Boolean

true para bloquear o usuário associado; caso contrário, false.

creationDate
DateTime

O objeto CreationDateDateTime para o usuário associado.

lastLoginDate
DateTime

O objeto LastLoginDateDateTime para o usuário associado.

lastActivityDate
DateTime

O objeto LastActivityDateDateTime para o usuário associado.

lastPasswordChangedDate
DateTime

O objeto LastPasswordChangedDateDateTime para o usuário associado.

lastLockoutDate
DateTime

O objeto LastLockoutDateDateTime para o usuário associado.

Exceções

providerName é null.

- ou -

providerName não for encontrado na coleção Providers.

O construtor não está disponível. Isso pode ocorrer se o aplicativo for direcionado ao Perfil de Cliente do .NET Framework 4. Para evitar essa exceção, derive sua classe do tipo e chame o construtor protegido padrão ou altere o aplicativo para visar a versão completa do .NET Framework.

Exemplos

O exemplo de código a seguir mostra uma implementação do CreateUser método para um provedor de associação. O método constrói um MembershipUser objeto retornado quando o usuário é adicionado com êxito ao armazenamento de dados.

public override MembershipUser CreateUser(string username,
         string password,
         string email,
         string passwordQuestion,
         string passwordAnswer,
         bool isApproved,
         object providerUserKey,
         out MembershipCreateStatus status)
{
  ValidatePasswordEventArgs args =
    new ValidatePasswordEventArgs(username, password, true);

  OnValidatingPassword(args);

  if (args.Cancel)
  {
    status = MembershipCreateStatus.InvalidPassword;
    return null;
  }

  if (RequiresUniqueEmail && GetUserNameByEmail(email) != "")
  {
    status = MembershipCreateStatus.DuplicateEmail;
    return null;
  }

  MembershipUser u = GetUser(username, false);

  if (u == null)
  {
    DateTime createDate = DateTime.Now;

    if (providerUserKey == null)
    {
      providerUserKey = Guid.NewGuid();
    }
    else
    {
      if (!(providerUserKey is Guid))
      {
        status = MembershipCreateStatus.InvalidProviderUserKey;
        return null;
      }
    }

    OdbcConnection conn = new OdbcConnection(ConnectionString);
    OdbcCommand cmd = new OdbcCommand("INSERT INTO Users " +
          " (PKID, Username, Password, Email, PasswordQuestion, " +
          " PasswordAnswer, IsApproved," +
          " Comment, CreationDate, LastPasswordChangedDate, LastActivityDate," +
          " ApplicationName, IsLockedOut, LastLockedOutDate," +
          " FailedPasswordAttemptCount, FailedPasswordAttemptWindowStart, " +
          " FailedPasswordAnswerAttemptCount, FailedPasswordAnswerAttemptWindowStart)" +
          " Values(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)", conn);

    cmd.Parameters.Add("@PKID", OdbcType.UniqueIdentifier).Value = providerUserKey;
    cmd.Parameters.Add("@Username", OdbcType.VarChar, 255).Value = username;
    cmd.Parameters.Add("@Password", OdbcType.VarChar, 255).Value = EncodePassword(password);
    cmd.Parameters.Add("@Email", OdbcType.VarChar, 128).Value = email;
    cmd.Parameters.Add("@PasswordQuestion", OdbcType.VarChar, 255).Value = passwordQuestion;
    cmd.Parameters.Add("@PasswordAnswer", OdbcType.VarChar, 255).Value = EncodePassword(passwordAnswer);
    cmd.Parameters.Add("@IsApproved", OdbcType.Bit).Value = isApproved;
    cmd.Parameters.Add("@Comment", OdbcType.VarChar, 255).Value = "";
    cmd.Parameters.Add("@CreationDate", OdbcType.DateTime).Value = createDate;
    cmd.Parameters.Add("@LastPasswordChangedDate", OdbcType.DateTime).Value = createDate;
    cmd.Parameters.Add("@LastActivityDate", OdbcType.DateTime).Value = createDate;
    cmd.Parameters.Add("@ApplicationName", OdbcType.VarChar, 255).Value = pApplicationName;
    cmd.Parameters.Add("@IsLockedOut", OdbcType.Bit).Value = false;
    cmd.Parameters.Add("@LastLockedOutDate", OdbcType.DateTime).Value = createDate;
    cmd.Parameters.Add("@FailedPasswordAttemptCount", OdbcType.Int).Value = 0;
    cmd.Parameters.Add("@FailedPasswordAttemptWindowStart", OdbcType.DateTime).Value = createDate;
    cmd.Parameters.Add("@FailedPasswordAnswerAttemptCount", OdbcType.Int).Value = 0;
    cmd.Parameters.Add("@FailedPasswordAnswerAttemptWindowStart", OdbcType.DateTime).Value = createDate;

    try
    {
      conn.Open();

      int recAdded = cmd.ExecuteNonQuery();

      if (recAdded > 0)
      {
        status = MembershipCreateStatus.Success;
      }
      else
      {
        status = MembershipCreateStatus.UserRejected;
      }
    }
    catch (OdbcException)
    {
      // Handle exception.

      status = MembershipCreateStatus.ProviderError;
    }
    finally
    {
      conn.Close();
    }

    return GetUser(username, false);
  }
  else
  {
    status = MembershipCreateStatus.DuplicateUserName;
  }

  return null;
}

Comentários

A criação de um novo MembershipUser objeto não adiciona um novo objeto de usuário de associação ao armazenamento de dados de associação. Para adicionar um novo usuário de associação ao armazenamento de dados de associação, use o CreateUser método . Observe que o CreateUser método retorna um MembershipUser objeto para o usuário associado adicionado ao armazenamento de dados.

MembershipUser os objetos podem ser construídos no código do aplicativo para uso com o UpdateUser método . Como alternativa, você também pode passar um MembershipUser objeto retornado do CreateUsermétodo , GetUser, GetAllUsers, FindUsersByNameou FindUsersByEmail para o UpdateUser método também.

MembershipUser os objetos também são comumente construídos por implementações de provedor de associação para os CreateUsermétodos , GetUser, GetAllUsers, FindUsersByNamee FindUsersByEmail .

Os nameparâmetros , emaile passwordQuestion são todos cortados antes de serem usados.

Confira também

Aplica-se a