Compartilhar via

SqlConnection.ChangePassword Método

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Altera a senha do SQL Server.

Sobrecargas

Nome Description
ChangePassword(String, SqlCredential, SecureString)

Altera a senha do SQL Server para o usuário indicado no objeto SqlCredential.
ChangePassword(String, String)

Altera a senha do SQL Server para o usuário indicado na cadeia de conexão para a nova senha especificada.

ChangePassword(String, SqlCredential, SecureString)

Origem:
System.Data.SqlClient.notsupported.cs

Altera a senha do SQL Server para o usuário indicado no objeto SqlCredential.

public:
 static void ChangePassword(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);
public static void ChangePassword(string connectionString, System.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);
static member ChangePassword : string * System.Data.SqlClient.SqlCredential * System.Security.SecureString -> unit
Public Shared Sub ChangePassword (connectionString As String, credential As SqlCredential, newSecurePassword As SecureString)

Parâmetros

connectionString
String

A cadeia de conexão que contém informações suficientes para se conectar a um servidor. A cadeia de conexão não deve usar nenhuma das seguintes palavras-chave de cadeia de conexão: Integrated Security = true, UserIdou Password; ou ContextConnection = true.

credential
SqlCredential

Um objeto SqlCredential.

newPasswordnewSecurePassword
SecureString

A nova senha. newPassword deve ser somente leitura. A senha também deve estar em conformidade com qualquer política de segurança de senha definida no servidor (por exemplo, comprimento mínimo e requisitos para caracteres específicos).

Exceções

ArgumentException

A cadeia de conexão contém qualquer combinação de UserId, Passwordou Integrated Security=true.

-ou-

A cadeia de conexão contém Context Connection=true.

-ou-

newSecurePassword (ou newPassword) é maior que 128 caracteres.

-ou-

newSecurePassword (ou newPassword) não é somente leitura.

-ou-

newSecurePassword (ou newPassword) é uma cadeia de caracteres vazia.

ArgumentNullException

Um dos parâmetros (connectionString, credentialou newSecurePassword) é nulo.

Confira também

Aplica-se a

ChangePassword(String, String)

Origem:
System.Data.SqlClient.notsupported.cs

Altera a senha do SQL Server para o usuário indicado na cadeia de conexão para a nova senha especificada.

public:
 static void ChangePassword(System::String ^ connectionString, System::String ^ newPassword);
public static void ChangePassword(string connectionString, string newPassword);
static member ChangePassword : string * string -> unit
Public Shared Sub ChangePassword (connectionString As String, newPassword As String)

Parâmetros

connectionString
String

A cadeia de conexão que contém informações suficientes para se conectar ao servidor desejado. A cadeia de conexão deve conter a ID do usuário e a senha atual.

newPassword
String

A nova senha a ser definida. Essa senha deve estar em conformidade com qualquer política de segurança de senha definida no servidor, incluindo comprimento mínimo, requisitos para caracteres específicos e assim por diante.

Exceções

ArgumentException

A cadeia de conexão inclui a opção de usar a segurança integrada.

Ou

O newPassword excede 128 caracteres.

ArgumentNullException

O parâmetro connectionString ou newPassword é nulo.

Comentários

Ao usar o SQL Server no Windows Server, você pode aproveitar a funcionalidade que permite que o aplicativo cliente forneça a senha atual e uma nova para alterar a senha existente. Os aplicativos podem implementar funcionalidades como solicitar ao usuário uma nova senha durante o logon inicial se a antiga tiver expirado e essa operação puder ser concluída sem intervenção do administrador.

Aviso

A Microsoft não recomenda fornecer seu nome de usuário e senha diretamente, pois é um padrão inseguro. Sempre que possível, use fluxos de autenticação mais seguros, como Identidades Gerenciadas para recursos do Azureou de autenticação do Windows para SQL Server.

O método ChangePassword altera a senha do SQL Server para o usuário indicado no parâmetro connectionString fornecido para o valor fornecido no parâmetro newPassword. Se a cadeia de conexão incluir a opção de segurança integrada (ou seja, "Segurança Integrada=True" ou equivalente), uma exceção será gerada.

Para determinar se a senha expirou, chamar o método Open gera um SqlException. Para indicar que a senha contida na cadeia de conexão deve ser redefinida, a propriedade Number da exceção contém o valor de status 18487 ou 18488. O primeiro valor (18487) indica que a senha expirou e a segunda (18488) indica que a senha deve ser redefinida antes de fazer logon.

Esse método abre sua própria conexão com o servidor, solicita a alteração de senha e fecha a conexão assim que ela é concluída. Essa conexão não é recuperada ou retornada para o pool de conexões do SQL Server.

Confira também

Aplica-se a