SqlConnection.ChangePassword Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Změní heslo SQL Serveru.

Přetížení

Name	Description
ChangePassword(String, SqlCredential, SecureString)	Změní heslo SQL Serveru pro uživatele uvedeného v objektu SqlCredential.
ChangePassword(String, String)	Změní heslo SQL Serveru pro uživatele označeného v připojovacím řetězci na zadané nové heslo.

ChangePassword(String, SqlCredential, SecureString)

Změní heslo SQL Serveru pro uživatele uvedeného v objektu 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)

Parametry

connectionString

String

Připojovací řetězec, který obsahuje dostatek informací pro připojení k serveru. Připojovací řetězec by neměl používat žádná z následujících klíčových slov připojovacího řetězce: Integrated Security = true, UserIdnebo Password; nebo ContextConnection = true.

credential

SqlCredential

Objekt SqlCredential.

newSecurePassword

SecureString

Nové heslo. newPassword musí být jen pro čtení. Heslo musí také splňovat všechny zásady zabezpečení hesel nastavené na serveru (například minimální délka a požadavky pro konkrétní znaky).

Výjimky

ArgumentException

Připojovací řetězec obsahuje libovolnou kombinaci UserId, Passwordnebo Integrated Security=true.

-nebo-

Připojovací řetězec obsahuje Context Connection=true.

-nebo-

newSecurePassword (nebo newPassword) je větší než 128 znaků.

-nebo-

newSecurePassword (nebo newPassword) není jen pro čtení.

-nebo-

newSecurePassword (nebo newPassword) je prázdný řetězec.

ArgumentNullException

Jeden z parametrů (connectionString, credentialnebo newSecurePassword) má hodnotu null.

Viz také

• přehled ADO.NET

ChangePassword(String, String)

Změní heslo SQL Serveru pro uživatele označeného v připojovacím řetězci na zadané nové heslo.

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)

Parametry

connectionString

String

Připojovací řetězec, který obsahuje dostatek informací pro připojení k požadovanému serveru. Připojovací řetězec musí obsahovat ID uživatele a aktuální heslo.

newPassword

String

Nové heslo, které chcete nastavit. Toto heslo musí splňovat všechny zásady zabezpečení hesel nastavené na serveru, včetně minimální délky, požadavků na konkrétní znaky atd.

Výjimky

ArgumentException

Připojovací řetězec obsahuje možnost použití integrovaného zabezpečení.

Nebo

newPassword přesahuje 128 znaků.

ArgumentNullException

Parametr connectionString nebo newPassword má hodnotu null.

Poznámky

Pokud používáte SQL Server na Windows Serveru, můžete využít funkce, které klientské aplikaci umožní zadat aktuální i nové heslo, aby bylo možné změnit stávající heslo. Aplikace můžou implementovat funkce, jako je výzva uživatele k zadání nového hesla při počátečním přihlášení, pokud jeho platnost vypršela, a tuto operaci je možné dokončit bez zásahu správce.

Varování

Microsoft nedoporučuje zadat vaše uživatelské jméno a heslo přímo, protože se jedná o nezabezpečený vzor. Pokud je to možné, používejte bezpečnější toky ověřování, jako jsou spravované identity pro prostředky Azurenebo ověřování systému Windows pro SQL Server.

Metoda ChangePassword změní heslo SQL Serveru pro uživatele uvedeného v zadaném parametru connectionString na hodnotu zadanou v parametru newPassword. Pokud připojovací řetězec obsahuje možnost integrovaného zabezpečení (tj. "Integrated Security=True" nebo ekvivalentní), vyvolá se výjimka.

Pokud chcete zjistit, že vypršela platnost hesla, vyvolá volání metody OpenSqlException. Aby bylo možné označit, že heslo obsažené v připojovacím řetězci musí být resetována, Number vlastnost výjimky obsahuje hodnotu stavu 18487 nebo 18488. První hodnota (18487) značí, že platnost hesla vypršela, a druhá hodnota (18488) značí, že se heslo musí resetovat před přihlášením.

Tato metoda otevře vlastní připojení k serveru, požádá o změnu hesla a ukončí připojení, jakmile se dokončí. Toto připojení se nenačte z fondu připojení SQL Serveru ani ho nevrátí.

Viz také

• připojovacích řetězců (ADO.NET)
• připojení ke zdroji dat (ADO.NET)
• použití zprostředkovatele dat rozhraní .NET Framework pro sql Server
• přehled ADO.NET