SqlConnection.ChangePassword Метод

Определение

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

System.Data.SqlClient

Сборка:

System.Data.dll

Изменяет пароль SQL Server.

Перегрузки

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, 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)

Параметры

connectionString

String

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

credential

SqlCredential

Объект SqlCredential.

newSecurePassword

SecureString

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

Исключения

ArgumentException

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

-или-

Строка подключения содержит Context Connection=true.

-или-

newSecurePassword (или newPassword) больше 128 символов.

-или-

newSecurePassword (или newPassword) не только для чтения.

-или-

newSecurePassword (или newPassword) — пустая строка.

ArgumentNullException

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

См. также раздел

• обзора ADO.NET

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.

Примеры

Предупреждение

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

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

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

Module Module1
    Sub Main()
System.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 System.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;
    }
}

Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Try
            DemonstrateChangePassword()
        Catch ex As Exception
            Console.WriteLine("Error: " & ex.Message)
        End Try
        Console.WriteLine("Press ENTER to continue...")
        Console.ReadLine()
    End Sub

    Private Sub DemonstrateChangePassword()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection()
            For i As Integer = 0 To 1
                ' 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.
                    Exit For

                Catch ex As SqlException _
                 When (i = 0 And (ex.Number = 18487 Or ex.Number = 18488))
                    ' You must reset the password.
                    connectionString = ModifyConnectionString( _
                     connectionString, GetNewPassword())

                Catch ex As SqlException
                    ' Bubble all other SqlException occurrences
                    ' back up to the caller.
                    Throw
                End Try
            Next
            Dim cmd As New SqlCommand("SELECT ProductID, Name FROM Product", cnn)
            ' Use the connection and command here...
        End Using
    End Sub

    Private Function ModifyConnectionString( _
     ByVal connectionString As String, ByVal NewPassword As String) As String

        ' Use the SqlConnectionStringBuilder class to modify the
        ' password portion of the connection string. 
        Dim builder As New SqlConnectionStringBuilder(connectionString)
        builder.Password = NewPassword
        Return builder.ConnectionString
    End Function

    Private Function GetNewPassword() As String
        ' 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()
    End Function

    Private Function GetConnectionString() As String
        ' 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.
        Dim builder As 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
    End Function
End Module

Комментарии

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

Предупреждение

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

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

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

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

См. также раздел

• строк подключения (ADO.NET)
• подключение к источнику данных (ADO.NET)
• Использование поставщика данных .NET Framework для SQL Server
• обзора ADO.NET