SqlConnection.ChangePassword Metódus

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Módosítja a SQL Server jelszavát.

Túlterhelések

Name	Description
ChangePassword(String, SqlCredential, SecureString)	A SqlCredential objektumban megjelölt felhasználó SQL Server jelszavának módosítása.
ChangePassword(String, String)	A kapcsolati karakterlánc megadott új jelszóra módosítja a SQL Server felhasználó jelszavát.

ChangePassword(String, SqlCredential, SecureString)

A SqlCredential objektumban megjelölt felhasználó SQL Server jelszavának módosítása.

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éterek

connectionString

String

A kiszolgálóhoz való csatlakozáshoz elegendő információt tartalmazó kapcsolati karakterlánc. A kapcsolati karakterlánc nem használhatja a következő kapcsolati karakterlánc kulcsszavakat: Integrated Security = true, UserId vagy Password; vagy ContextConnection = true.

credential

SqlCredential

Egy SqlCredential objektum.

newSecurePassword

SecureString

Az új jelszó. newPassword csak olvashatónak kell lennie. A jelszónak meg kell felelnie a kiszolgálón beállított jelszóbiztonsági szabályzatoknak is (például a minimális hossznak és az adott karakterekre vonatkozó követelményeknek).

Kivételek

ArgumentException

A kapcsolati karakterlánc UserId, Password vagy Integrated Security=true kombinációját tartalmazza.

-vagy-

A kapcsolati karakterlánc Context Connection=true tartalmaz.

-vagy-

newSecurePassword (vagy newPassword) 128 karakternél nagyobb.

-vagy-

newSecurePassword (vagy newPassword) nem csak olvasható.

-vagy-

newSecurePassword (vagy newPassword) üres sztring.

ArgumentNullException

Az egyik paraméter (connectionStringvagy credentialnewSecurePassword) null értékű.

Lásd még

• ADO.NET áttekintése

ChangePassword(String, String)

A kapcsolati karakterlánc megadott új jelszóra módosítja a SQL Server felhasználó jelszavát.

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éterek

connectionString

String

A kapcsolati karakterlánc, amely elegendő információt tartalmaz a kívánt kiszolgálóhoz való csatlakozáshoz. A kapcsolati karakterlánc tartalmaznia kell a felhasználói azonosítót és az aktuális jelszót.

newPassword

String

A beállítani kívánt új jelszó. Ennek a jelszónak meg kell felelnie a kiszolgálón beállított jelszóbiztonsági szabályzatoknak, beleértve a minimális hosszt, az adott karakterekre vonatkozó követelményeket stb.

Kivételek

ArgumentException

A kapcsolati karakterlánc tartalmazza az integrált biztonság használatát.

Vagy

A newPassword karakter értéke meghaladja a 128 karaktert.

ArgumentNullException

connectionString A paraméter vagy newPassword null értékű.

Megjegyzések

Ha SQL Server használ a Windows Server, kihasználhatja azokat a funkciókat, amelyekkel az ügyfélalkalmazás az aktuális és az új jelszót is megadhatja a meglévő jelszó módosításához. Az alkalmazások olyan funkciókat implementálhatnak, mint például új jelszó kérése a kezdeti bejelentkezés során, ha a régi lejárt, és ez a művelet rendszergazdai beavatkozás nélkül is elvégezhető.

Warning

Microsoft nem javasolja, hogy közvetlenül adja meg a felhasználónevet és a jelszót, mert ez egy nem biztonságos minta. Ahol lehetséges, használjon biztonságosabb hitelesítési folyamatokat, például A felügyelt identitások Azure erőforrásokhoz vagy Windows authentication SQL Server.

A ChangePassword metódus a megadott connectionString paraméterben megadott felhasználó SQL Server jelszavát a newPassword paraméterben megadott értékre módosítja. Ha a kapcsolati karakterlánc tartalmazza az integrált biztonság lehetőségét (azaz "Integrated Security=True" vagy azzal egyenértékű), a rendszer kivételt jelez.

A jelszó lejártának megállapításához hívja meg a Open metódust SqlException. Annak jelzéséhez, hogy a kapcsolati karakterlánc belül található jelszót alaphelyzetbe kell állítani, a kivétel Number tulajdonsága az 18487 vagy 18488 állapotértéket tartalmazza. Az első érték (18487) azt jelzi, hogy a jelszó lejárt, a második (18488) pedig azt jelzi, hogy bejelentkezés előtt alaphelyzetbe kell állítani a jelszót.

Ez a metódus megnyitja a saját kapcsolatát a kiszolgálóval, kéri a jelszó módosítását, és amint befejeződött, bezárja a kapcsolatot. Ezt a kapcsolatot a rendszer nem kéri le vagy adja vissza a SQL Server kapcsolatkészletből.

Lásd még

• Kapcsolódási sztringek (ADO.NET)
• Csatlakozás adatforráshoz (ADO.NET)
• A .NET-keretrendszer Data Provider használata SQL Server
• ADO.NET áttekintése