SqlConnection.ChangePassword Méthode

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

Modifie le mot de passe SQL Server.

Surcharges

Nom	Description
ChangePassword(String, SqlCredential, SecureString)	Modifie le mot de passe SQL Server de l’utilisateur indiqué dans l’objet SqlCredential.
ChangePassword(String, String)	Modifie le mot de passe SQL Server de l’utilisateur indiqué dans la chaîne de connexion par le nouveau mot de passe spécifié.

ChangePassword(String, SqlCredential, SecureString)

Modifie le mot de passe SQL Server de l’utilisateur indiqué dans l’objet 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)

Paramètres

connectionString

String

Chaîne de connexion qui contient suffisamment d’informations pour se connecter à un serveur. La chaîne de connexion ne doit pas utiliser les mots clés de chaîne de connexion suivants : Integrated Security = true, UserIdou Password; ou ContextConnection = true.

credential

SqlCredential

Objet SqlCredential.

newSecurePassword

SecureString

Nouveau mot de passe. newPassword doit être en lecture seule. Le mot de passe doit également se conformer à toute stratégie de sécurité de mot de passe définie sur le serveur (par exemple, longueur minimale et exigences pour des caractères spécifiques).

Exceptions

ArgumentException

La chaîne de connexion contient n’importe quelle combinaison de UserId, de Passwordou de Integrated Security=true.

-ou-

La chaîne de connexion contient Context Connection=true.

-ou-

newSecurePassword (ou newPassword) est supérieur à 128 caractères.

-ou-

newSecurePassword (ou newPassword) n’est pas en lecture seule.

-ou-

newSecurePassword (ou newPassword) est une chaîne vide.

ArgumentNullException

L’un des paramètres (connectionString, credentialou newSecurePassword) est null.

Voir aussi

• ADO.NET Vue d’ensemble

ChangePassword(String, String)

Modifie le mot de passe SQL Server de l’utilisateur indiqué dans la chaîne de connexion par le nouveau mot de passe spécifié.

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)

Paramètres

connectionString

String

Chaîne de connexion qui contient suffisamment d’informations pour se connecter au serveur souhaité. La chaîne de connexion doit contenir l’ID utilisateur et le mot de passe actuel.

newPassword

String

Nouveau mot de passe à définir. Ce mot de passe doit se conformer à toute stratégie de sécurité de mot de passe définie sur le serveur, y compris la longueur minimale, les exigences pour des caractères spécifiques, et ainsi de suite.

Exceptions

ArgumentException

La chaîne de connexion inclut l’option permettant d’utiliser la sécurité intégrée.

Ou

Le newPassword dépasse 128 caractères.

ArgumentNullException

Le connectionString ou le paramètre newPassword a la valeur Null.

Remarques

Lorsque vous utilisez SQL Server sur Windows Server, vous pouvez tirer parti des fonctionnalités qui permettent à l’application cliente de fournir le mot de passe actuel et un nouveau mot de passe afin de modifier le mot de passe existant. Les applications peuvent implémenter des fonctionnalités telles que l’invite de l’utilisateur à entrer un nouveau mot de passe lors de la connexion initiale si l’ancienne a expiré, et cette opération peut être effectuée sans intervention de l’administrateur.

Avertissement

Microsoft ne recommande pas de fournir directement votre nom d’utilisateur et votre mot de passe, car il s’agit d’un modèle non sécurisé. Dans la mesure du possible, utilisez des flux d’authentification plus sécurisés, tels que identités managées pour les ressources Azure, ou l’authentification Windows pour SQL Server.

La méthode ChangePassword modifie le mot de passe SQL Server de l’utilisateur indiqué dans le paramètre connectionString fourni par la valeur fournie dans le paramètre newPassword. Si la chaîne de connexion inclut l’option de sécurité intégrée (autrement dit, « Integrated Security=True » ou l’équivalent), une exception est levée.

Pour déterminer que le mot de passe a expiré, l’appel de la méthode Open déclenche une SqlException. Pour indiquer que le mot de passe contenu dans la chaîne de connexion doit être réinitialisé, la propriété Number pour l’exception contient la valeur d’état 18487 ou 18488. La première valeur (18487) indique que le mot de passe a expiré et le deuxième (18488) indique que le mot de passe doit être réinitialisé avant de vous connecter.

Cette méthode ouvre sa propre connexion au serveur, demande la modification du mot de passe et ferme la connexion dès qu’elle est terminée. Cette connexion n’est pas récupérée ou retournée au pool de connexions SQL Server.

Voir aussi

• chaînes de connexion (ADO.NET)
• connexion à une source de données (ADO.NET)
• utiliser le fournisseur de données .NET Framework pour SQL Server
• ADO.NET Vue d’ensemble