语言

SqlConnection.ChangePassword 方法

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.dll

更改 SQL Server 密码。

重载

名称 说明
ChangePassword(String, SqlCredential, SecureString)

更改 SqlCredential 对象中指示的用户的 SQL Server 密码。
ChangePassword(String, String)

将连接字符串中指示的用户的 SQL Server 密码更改为指定的新密码。

ChangePassword(String, SqlCredential, SecureString)

Source:
System.Data.SqlClient.notsupported.cs

更改 SqlCredential 对象中指示的用户的 SQL Server 密码。

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)

参数

connectionString
String

包含足够信息的连接字符串，用于连接到服务器。 连接字符串不应使用以下任何连接字符串关键字：Integrated Security = true、UserId或 Password;或 ContextConnection = true。

credential
SqlCredential

SqlCredential 对象。

newPasswordnewSecurePassword
SecureString

新密码。 newPassword 必须是只读的。 密码还必须符合服务器上设置的任何密码安全策略（例如，特定字符的最小长度和要求）。

例外

ArgumentException

连接字符串包含 UserId、Password或 Integrated Security=true的任意组合。

-或-

连接字符串包含 Context Connection=true。

-或-

newSecurePassword（或 newPassword）大于 128 个字符。

-或-

newSecurePassword（或 newPassword）不只读。

-或-

newSecurePassword（或 newPassword）是空字符串。

ArgumentNullException

其中一个参数（connectionString、credential或 newSecurePassword）为 null。

另请参阅

适用于

ChangePassword(String, String)

Source:
System.Data.SqlClient.notsupported.cs

将连接字符串中指示的用户的 SQL Server 密码更改为指定的新密码。

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)

参数

connectionString
String

包含足够信息的连接字符串，用于连接到所需的服务器。 连接字符串必须包含用户 ID 和当前密码。

newPassword
String

要设置的新密码。 此密码必须符合服务器上设置的任何密码安全策略，包括最小长度、特定字符的要求等。

例外

ArgumentException

连接字符串包括使用集成安全性的选项。

或

newPassword 超过 128 个字符。

ArgumentNullException

connectionString 或 newPassword 参数为 null。

注解

在 Windows Server 上使用 SQL Server 时，可以利用允许客户端应用程序同时提供当前密码和新密码的功能，以更改现有密码。 应用程序可以在初始登录期间提示用户输入新密码（如果旧密码已过期），并且无需管理员干预即可完成此操作。

Warning

Microsoft不建议直接提供用户名和密码，因为它是不安全模式。 如果可能，请对Azure资源使用更安全的身份验证流，例如 Managed Identities，或 Windows 身份验证 for SQL Server。

ChangePassword 方法将提供的 connectionString 参数中指示的用户的 SQL Server 密码更改为 newPassword 参数中提供的值。 如果连接字符串包含集成安全性的选项（即“Integrated Security=True”或等效项），则会引发异常。

若要确定密码已过期，调用 Open 方法将引发 SqlException。 若要指示必须重置连接字符串中包含的密码，异常的 Number 属性包含状态值 18487 或 18488。 第一个值 （18487） 指示密码已过期，第二个值 （18488） 指示在登录之前必须重置密码。

此方法打开与服务器自身的连接，请求密码更改，并在连接完成后立即关闭连接。 不会从 SQL Server 连接池中检索或返回此连接。

另请参阅

适用于