SqlConnection.ChangePassword Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Cambia la contraseña de SQL Server.

Sobrecargas

Nombre	Description
ChangePassword(String, SqlCredential, SecureString)	Cambia la contraseña de SQL Server para el usuario indicado en el objeto SqlCredential.
ChangePassword(String, String)	Cambia la contraseña de SQL Server para el usuario indicado en la cadena de conexión a la nueva contraseña especificada.

ChangePassword(String, SqlCredential, SecureString)

Cambia la contraseña de SQL Server para el usuario indicado en el objeto 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)

Parámetros

connectionString

String

Cadena de conexión que contiene suficiente información para conectarse a un servidor. La cadena de conexión no debe usar ninguna de las siguientes palabras clave de cadena de conexión: Integrated Security = true, UserIdo Password; o ContextConnection = true.

credential

SqlCredential

Objeto SqlCredential.

newSecurePassword

SecureString

Nueva contraseña. newPassword deben ser de solo lectura. La contraseña también debe cumplir con cualquier directiva de seguridad de contraseña establecida en el servidor (por ejemplo, longitud mínima y requisitos para caracteres específicos).

Excepciones

ArgumentException

La cadena de conexión contiene cualquier combinación de UserId, Passwordo Integrated Security=true.

-o-

La cadena de conexión contiene Context Connection=true.

-o-

newSecurePassword (o newPassword) es mayor que 128 caracteres.

-o-

newSecurePassword (o newPassword) no es de solo lectura.

-o-

newSecurePassword (o newPassword) es una cadena vacía.

ArgumentNullException

Uno de los parámetros (connectionString, credentialo newSecurePassword) es NULL.

Consulte también

• información general de ADO.NET

ChangePassword(String, String)

Cambia la contraseña de SQL Server para el usuario indicado en la cadena de conexión a la nueva contraseña especificada.

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)

Parámetros

connectionString

String

Cadena de conexión que contiene suficiente información para conectarse al servidor que desee. La cadena de conexión debe contener el identificador de usuario y la contraseña actual.

newPassword

String

Nueva contraseña que se va a establecer. Esta contraseña debe cumplir con cualquier directiva de seguridad de contraseña establecida en el servidor, incluida la longitud mínima, los requisitos para caracteres específicos, etc.

Excepciones

ArgumentException

La cadena de conexión incluye la opción de usar la seguridad integrada.

O

El newPassword supera los 128 caracteres.

ArgumentNullException

El connectionString o el parámetro newPassword es NULL.

Comentarios

Al usar SQL Server en Windows Server, puede aprovechar las ventajas de la funcionalidad que permite que la aplicación cliente proporcione tanto la contraseña actual como una nueva para cambiar la contraseña existente. Las aplicaciones pueden implementar funcionalidades como solicitar al usuario una nueva contraseña durante el inicio de sesión inicial si el anterior ha expirado y esta operación se puede completar sin intervención del administrador.

Advertencia

Microsoft no recomienda proporcionar el nombre de usuario y la contraseña directamente, ya que es un patrón inseguro. Siempre que sea posible, use flujos de autenticación más seguros, como identidades administradas para recursos de Azureo autenticación de Windows para SQL Server.

El método ChangePassword cambia la contraseña de SQL Server para el usuario indicado en el parámetro connectionString proporcionado al valor proporcionado en el parámetro newPassword. Si la cadena de conexión incluye la opción de seguridad integrada (es decir, "Integrated Security=True" o el equivalente), se produce una excepción.

Para determinar que la contraseña ha expirado, al llamar al método Open se genera un SqlException. Para indicar que se debe restablecer la contraseña contenida en la cadena de conexión, la propiedad Number para la excepción contiene el valor de estado 18487 o 18488. El primer valor (18487) indica que la contraseña ha expirado y la segunda (18488) indica que la contraseña debe restablecerse antes de iniciar sesión.

Este método abre su propia conexión con el servidor, solicita el cambio de contraseña y cierra la conexión tan pronto como se haya completado. Esta conexión no se recupera ni se devuelve al grupo de conexiones de SQL Server.

Consulte también

• de cadenas de conexión (ADO.NET) de
• Conectarse a un origen de datos (ADO.NET)
• usar el proveedor de datos de .NET Framework para SQL Server
• información general de ADO.NET