SqlConnection.ChangePassword Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Mengubah kata sandi SQL Server.

Overload

Nama	Deskripsi
ChangePassword(String, SqlCredential, SecureString)	Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam objek SqlCredential.
ChangePassword(String, String)	Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam string koneksi ke kata sandi baru yang ditentukan.

ChangePassword(String, SqlCredential, SecureString)

Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam objek 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)

Parameter

connectionString

String

String koneksi yang berisi informasi yang cukup untuk menyambungkan ke server. String koneksi tidak boleh menggunakan salah satu kata kunci string koneksi berikut: Integrated Security = true, UserId, atau Password; atau ContextConnection = true.

credential

SqlCredential

Objek SqlCredential.

newSecurePassword

SecureString

Kata sandi baru. newPassword harus dibaca saja. Kata sandi juga harus mematuhi kebijakan keamanan kata sandi apa pun yang ditetapkan di server (misalnya, panjang dan persyaratan minimum untuk karakter tertentu).

Pengecualian

ArgumentException

String koneksi berisi kombinasi UserId, Password, atau Integrated Security=true.

-atau-

String koneksi berisi Context Connection=true.

-atau-

newSecurePassword (atau newPassword) lebih besar dari 128 karakter.

-atau-

newSecurePassword (atau newPassword) tidak hanya dibaca.

-atau-

newSecurePassword (atau newPassword) adalah string kosong.

ArgumentNullException

Salah satu parameter (connectionString, credential, atau newSecurePassword) adalah null.

Lihat juga

• Gambaran Umum ADO.NET

ChangePassword(String, String)

Mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam string koneksi ke kata sandi baru yang ditentukan.

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)

Parameter

connectionString

String

String koneksi yang berisi informasi yang cukup untuk menyambungkan ke server yang Anda inginkan. String koneksi harus berisi ID pengguna dan kata sandi saat ini.

newPassword

String

Kata sandi baru yang akan diatur. Kata sandi ini harus mematuhi kebijakan keamanan kata sandi apa pun yang ditetapkan di server, termasuk panjang minimum, persyaratan untuk karakter tertentu, dan sebagainya.

Pengecualian

ArgumentException

String koneksi menyertakan opsi untuk menggunakan keamanan terintegrasi.

Atau

newPassword melebihi 128 karakter.

ArgumentNullException

Parameter connectionString atau newPassword null.

Keterangan

Saat Anda menggunakan SQL Server di Windows Server, Anda dapat memanfaatkan fungsionalitas yang memungkinkan aplikasi klien menyediakan kata sandi saat ini dan baru untuk mengubah kata sandi yang ada. Aplikasi dapat menerapkan fungsionalitas seperti meminta kata sandi baru kepada pengguna selama masuk awal jika yang lama telah kedaluwarsa, dan operasi ini dapat diselesaikan tanpa intervensi administrator.

Peringatan

Microsoft tidak menyarankan untuk memberikan nama pengguna dan kata sandi Anda secara langsung, karena ini adalah pola yang tidak aman. Jika memungkinkan, gunakan alur autentikasi yang lebih aman, seperti identitas terkelola untuk sumber daya Azure, atau autentikasi Windows untuk SQL Server.

Metode ChangePassword mengubah kata sandi SQL Server untuk pengguna yang ditunjukkan dalam parameter connectionString yang disediakan ke nilai yang disediakan dalam parameter newPassword. Jika string koneksi menyertakan opsi untuk keamanan terintegrasi (yaitu, "Integrated Security=True" atau yang setara), pengecualian akan dilemparkan.

Untuk menentukan bahwa kata sandi telah kedaluwarsa, memanggil metode Open meningkatkan SqlException. Untuk menunjukkan bahwa kata sandi yang terkandung dalam string koneksi harus diatur ulang, properti Number untuk pengecualian berisi nilai status 18487 atau 18488. Nilai pertama (18487) menunjukkan bahwa kata sandi telah kedaluwarsa dan yang kedua (18488) menunjukkan bahwa kata sandi harus diatur ulang sebelum masuk.

Metode ini membuka koneksinya sendiri ke server, meminta perubahan kata sandi, dan menutup koneksi segera setelah selesai. Koneksi ini tidak diambil dari atau dikembalikan ke kumpulan koneksi SQL Server.

Lihat juga

• String Koneksi (ADO.NET)
• Menyambungkan ke Sumber Data (ADO.NET)
• Menggunakan Penyedia Data .NET Framework untuk SQL Server
• Gambaran Umum ADO.NET