語言

SqlConnection.ChangePassword 方法

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.dll

變更 SQL Server 密碼。

多載

名稱 Description
ChangePassword(String, SqlCredential, SecureString)

變更 SqlCredential 物件中所指出使用者的 SQL Server 密碼。
ChangePassword(String, String)

將連接字串中指定的使用者 SQL Server 密碼更改為指定的新密碼。

ChangePassword(String, SqlCredential, SecureString)

來源:
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)

來源:
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

包含足夠資訊的連接字串，可連線到您想要的伺服器。 連接字串必須包含使用者識別碼和目前的密碼。

newPassword
String

要設定的新密碼。 此密碼必須符合伺服器上設定的任何密碼安全策略，包括長度下限、特定字元的需求等等。

例外狀況

ArgumentException

連接字串包含使用整合式安全性的選項。

或

newPassword 超過 128 個字元。

ArgumentNullException

connectionString 或 newPassword 參數為 null。

備註

當你在 Windows Server 上使用 SQL Server 時，可以利用客戶端應用程式同時提供現有和新密碼來更改現有密碼的功能。 如果舊密碼已過期，應用程式可以實作功能，例如在初始登入期間提示使用者輸入新密碼，而且不需要系統管理員介入即可完成這項作業。

警告

Microsoft 不建議直接提供使用者名稱和密碼，因為這是不安全的模式。 若可能，使用更安全的認證流程，如Azure資源Managed Identities，或SQL ServerWindows 驗證。

ChangePassword 方法會將所提供之 connectionString 參數中所指示之使用者的 SQL Server 密碼變更為 newPassword 參數中提供的值。 如果連接字串包含整合式安全性的選項（也就是「整合式安全性=True」或對等專案），則會擲回例外狀況。

若要判斷密碼已過期，呼叫 Open 方法會引發 SqlException。 若要指出連接字串中包含的密碼必須重設，例外狀況的 Number 屬性會包含狀態值 18487 或 18488。 第一個值 （18487） 表示密碼已過期，而第二個值 （18488） 表示在登入之前必須重設密碼。

這個方法會開啟自己與伺服器的連線、要求密碼變更，並在連線完成後立即關閉。 此連線不會從 SQL Server 連接集區擷取或傳回。

另請參閱

適用於