SqlConnection.ChangePassword Метод

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v7.0.1

Перегрузки

Имя	Описание
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

Строка подключения, содержащая достаточную информацию для подключения к серверу. Connection string не должны использовать ни одно из следующих ключевых слов строка подключения: Integrated Security = true, или ; или PasswordContextConnection = true. UserId

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 System;
using System.Data;
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 разработчики могут воспользоваться функциональными возможностями, которые позволяют клиентскому приложению предоставлять текущий и новый пароль, чтобы изменить существующий пароль. Приложения могут реализовать такие функции, как запрос пользователя на новый пароль во время начального входа, если срок действия старой версии истек, и эта операция может быть завершена без вмешательства администратора. Этот метод изменяет пароль SQL Server для пользователя, указанного в предоставленном connectionString параметре, на значение, указанное в параметреnewPassword. Если строка подключения включает параметр встроенной безопасности (то есть "Встроенная безопасность=True" или эквивалент), создается исключение. Чтобы определить срок действия пароля, вызов метода Open() вызывает SqlException. Чтобы указать, что пароль, содержащийся в строке подключения, необходимо сбросить, свойство Number для исключения содержит значение состояния 18487 или 18488. Первое значение (18487) указывает, что срок действия пароля истек, а второй (18488) указывает, что пароль необходимо сбросить перед входом. Этот метод открывает собственное подключение к серверу, запрашивает изменение пароля и закрывает подключение сразу после завершения. Это подключение не извлекается из пула подключений SQL Server и не возвращается.