SqlConnection.ChangePassword Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

ChangePassword(String, SqlCredential, SecureString)	Изменяет пароль SQL Server для пользователя, указанного в объекте SqlCredential.
ChangePassword(String, String)	Заменяет пароль SQL Server для пользователя, указанного в строке подключения, заданным новым паролем.

ChangePassword(String, SqlCredential, SecureString)

Изменяет пароль SQL Server для пользователя, указанного в объекте SqlCredential.

public:
 static void ChangePassword(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential, System::Security::SecureString ^ newSecurePassword);

public static void ChangePassword (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential, System.Security.SecureString newSecurePassword);

static member ChangePassword : string * Microsoft.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.

newSecurePassword

SecureString

Новый пароль. newSecurePassword должен быть только для чтения. Пароль должен также соответствовать установленной на сервере политике безопасности паролей, (например, минимальной длине и требованиям к использованию определенных символов).

Исключения

ArgumentException

Строка подключения содержит любое сочетание UserId, Password и Integrated Security=true.

-или-

Длина значения параметра newSecurePassword более 128 символов.

-или-

newSecurePassword не является только для чтения.

-или-

Параметр newSecurePassword равен пустой строке.

ArgumentNullException

Один из параметров (connectionString, credential или newSecurePassword) имеет значение NULL.

ChangePassword(String, String)

Заменяет пароль 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.

Примеры

Ниже приведен простой пример изменения пароля.

class Program {  
   static void Main(string[] args) {  
      Microsoft.Data.SqlClient.SqlConnection.ChangePassword(  
        "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",   
       "new_password");  
   }  
}  

Module Module1  
    Sub Main()  
Microsoft.Data.SqlClient.SqlConnection.ChangePassword(  
        "Data Source=a_server;Initial Catalog=a_database;UID=user;PWD=old_password",   
       "new_password")  
    End Sub  
End Module  

В следующем консольном приложении показаны проблемы, связанные с изменением пароля пользователя, так как срок действия текущего пароля истек.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            DemonstrateChangePassword();
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error: " + ex.Message);
        }
        Console.WriteLine("Press ENTER to continue...");
        Console.ReadLine();
    }

    private static void DemonstrateChangePassword()
    {
        // Retrieve the connection string. In a production application,
        // this string should not be contained within the source code.
        string connectionString = GetConnectionString();

        using (SqlConnection cnn = new SqlConnection())
        {
            for (int i = 0; i <= 1; i++)
            {
                // Run this loop at most two times. If the first attempt fails, 
                // the code checks the Number property of the SqlException object.
                // If that contains the special values 18487 or 18488, the code 
                // attempts to set the user's password to a new value. 
                // Assuming this succeeds, the second pass through 
                // successfully opens the connection.
                // If not, the exception handler catches the exception.
                try
                {
                    cnn.ConnectionString = connectionString;
                    cnn.Open();
                    // Once this succeeds, just get out of the loop.
                    // No need to try again if the connection is already open.
                    break;
                }
                catch (SqlException ex)
                {
                    if (i == 0 && ((ex.Number == 18487) || (ex.Number == 18488)))
                    {
                        // You must reset the password. 
                        connectionString =
                            ModifyConnectionString(connectionString,
                            GetNewPassword());

                    }
                    else
                        // Bubble all other SqlException occurrences
                        // back up to the caller.
                        throw;
                }
            }
            SqlCommand cmd = new SqlCommand(
                "SELECT ProductID, Name FROM Product", cnn);
            // Use the connection and command here...
        }
    }

    private static string ModifyConnectionString(
        string connectionString, string NewPassword)
    {

        // Use the SqlConnectionStringBuilder class to modify the
        // password portion of the connection string. 
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(connectionString);
        builder.Password = NewPassword;
        return builder.ConnectionString;
    }

    private static string GetNewPassword()
    {
        // In a real application, you might display a modal
        // dialog box to retrieve the new password. The concepts
        // are the same as for this simple console application, however.
        Console.Write("Your password must be reset. Enter a new password: ");
        return Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // For this demonstration, the connection string must
        // contain both user and password information. In your own
        // application, you might want to retrieve this setting
        // from a config file, or from some other source.

        // In a production application, you would want to 
        // display a modal form that could gather user and password
        // information.
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Data Source=(local);Initial Catalog=AdventureWorks");

        Console.Write("Enter your user id: ");
        builder.UserID = Console.ReadLine();
        Console.Write("Enter your password: ");
        builder.Password = Console.ReadLine();

        return builder.ConnectionString;
    }
}

Комментарии

При использовании SQL Server в Windows Server разработчики могут воспользоваться функциями, которые позволяют клиентскому приложению предоставлять как текущий, так и новый пароль, чтобы изменить существующий пароль. Приложения могут реализовать такие функции, как запрос пользователя ввести новый пароль при первоначальном входе, если срок действия старого пароля истек, и эту операцию можно выполнить без вмешательства администратора.

Метод ChangePassword изменяет пароль SQL Server для пользователя, указанного в предоставленном connectionString параметре, на значение, указанное в параметре newPassword . Если строка подключения включает параметр для интегрированной безопасности (т. е. "Встроенная безопасность=True" или эквивалент), создается исключение.

Чтобы определить, что срок действия пароля истек, вызов Open метода вызывает .SqlException Чтобы указать, что пароль, содержащийся в строка подключения, должен быть сброшен, Number свойство исключения содержит значение состояния 18487 или 18488. Первое значение (18487) означает, что срок действия пароля истек, а второй (18488) указывает, что пароль необходимо сбросить перед входом в систему.

Этот метод открывает собственное подключение к серверу, запрашивает изменение пароля и закрывает подключение сразу после его завершения. Это подключение не извлекается из пула подключений SQL Server и не возвращается в нее.