SqlConnection.ChangePassword Método

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Altera a palavra-passe do SQL Server.

Sobrecargas

Name Description
ChangePassword(String, SqlCredential, SecureString)

Altera a palavra-passe SQL Server do utilizador indicada no objeto SqlCredential.
ChangePassword(String, String)

Altera a palavra-passe do SQL Server para o utilizador indicada na cadeia de ligação para a nova palavra-passe especificada.

ChangePassword(String, SqlCredential, SecureString)

Altera a palavra-passe SQL Server do utilizador indicada 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 ligação que contém informação suficiente para se ligar a um servidor. A cadeia de ligação não deve usar nenhuma das seguintes palavras-chave cadeia de ligação: Integrated Security = true, UserId, ou Password; ou ContextConnection = true.

credential
SqlCredential

Um objeto SqlCredential.

newPasswordnewSecurePassword
SecureString

A nova senha. newPassword deve ser apenas lida. A palavra-passe deve também cumprir qualquer política de segurança de palavra-passe definida no servidor (por exemplo, comprimento mínimo e requisitos para caracteres específicos).

Exceções

ArgumentException

O cadeia de ligação contém qualquer combinação de UserId, Password ou Integrated Security=true.

-ou-

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

-ou-

newSecurePassword (ou newPassword) tem mais de 128 caracteres.

-ou-

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

-ou-

newSecurePassword (ou newPassword) é uma corda vazia.

ArgumentNullException

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

Ver também

Aplica-se a

ChangePassword(String, String)

Altera a palavra-passe do SQL Server para o utilizador indicada na cadeia de ligação para a nova palavra-passe 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 ligação que contém informação suficiente para se ligar ao servidor que queres. A cadeia de ligação deve conter o ID de utilizador e a palavra-passe atual.

newPassword
String

A nova palavra-passe a definir. Esta palavra-passe deve cumprir qualquer política de segurança de palavras-passe definida no servidor, incluindo comprimento mínimo, requisitos para caracteres específicos, e assim por diante.

Exceções

ArgumentException

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

Ou

Ultrapassa newPassword os 128 caracteres.

ArgumentNullException

Ou o connectionString ou o newPassword parâmetro é nulo.

Observações

Quando está a usar o SQL Server no Windows Server, pode aproveitar uma funcionalidade que permite à aplicação cliente fornecer tanto a palavra-passe atual como uma nova para alterar a palavra-passe existente. As aplicações podem implementar funcionalidades como pedir ao utilizador uma nova palavra-passe durante o login inicial, caso a antiga tenha expirado, e esta operação pode ser realizada sem intervenção do administrador.

Warning

A Microsoft não recomenda fornecer diretamente o seu nome de utilizador e palavra-passe, porque é um padrão inseguro. Sempre que possível, utilize fluxos de autenticação mais seguros, como Identidades Geridas para Azure recursos, ou Windows authentication para SQL Server.

O método ChangePassword altera a palavra-passe SQL Server do utilizador indicada no parâmetro connectionString fornecido pelo valor fornecido no parâmetro newPassword. Se a cadeia de ligação incluir a opção de segurança integrada (ou seja, "Integrated Security=True" ou equivalente), é lançada uma exceção.

Para determinar que a palavra-passe expirou, chamar o Open método gera um SqlException. Para indicar que a palavra-passe contida no cadeia de ligação deve ser redefinida, a propriedade Number para a exceção contém o valor de estado 18487 ou 18488. O primeiro valor (18487) indica que a palavra-passe expirou e o segundo (18488) indica que a palavra-passe deve ser redefinida antes de iniciar sessão.

Este método abre a sua própria ligação ao servidor, solicita a alteração da palavra-passe e fecha a ligação assim que termina. Esta ligação não é recuperada nem devolvida ao pool de conexões do SQL Server.

Ver também

Aplica-se a