SqlConnectionStringBuilder.Remove(String) Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.SqlClient.dll

Paquete:

System.Data.SqlClient v4.9.0

Source:

System.Data.SqlClient.notsupported.cs

Quita la entrada con la clave especificada de la instancia de SqlConnectionStringBuilder.

public:
 override bool Remove(System::String ^ keyword);

public override bool Remove (string keyword);

override this.Remove : string -> bool

Public Overrides Function Remove (keyword As String) As Boolean

Parámetros

keyword

String

Clave del par clave-valor que se va a quitar de la cadena de conexión de este SqlConnectionStringBuilder.

Devoluciones

Boolean

true si la clave existía dentro de la cadena de conexión y se quitó; false si la clave no existía.

Excepciones

ArgumentNullException

keyword es null (Nothing en Visual Basic)

Ejemplos

En el ejemplo siguiente se convierte una cadena de conexión existente del uso de la autenticación de SQL Server a la autenticación de Windows (seguridad integrada). El ejemplo funciona quitando el nombre de usuario y la contraseña de la cadena de conexión y estableciendo la propiedad IntegratedSecurity del objeto SqlConnectionStringBuilder.

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.

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=myPassw0rd;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = new(connectString);
            Console.WriteLine($"Original: {builder.ConnectionString}");

            // Remove the User ID and Password.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Enable integrated security.
            builder.IntegratedSecurity = true;

            Console.WriteLine($"Modified: {builder.ConnectionString}");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
/* This code example produces the following output:
 * Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=myPassw0rd
 * Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
 */

    Dim connectString As String =
     "Data Source=(local);User ID=ab;Password=a1Pass@@11;" &
     "Initial Catalog=AdventureWorks"

    Dim builder As New SqlConnectionStringBuilder(connectString)
    Console.WriteLine("Original: " & builder.ConnectionString)

    ' Remove the user ID and password.
    builder.Remove("User ID")
    builder.Remove("Password")

    ' Turn on integrated security:
    builder.IntegratedSecurity = True

    Console.WriteLine("Modified: " & builder.ConnectionString)

Catch ex As Exception
    Console.WriteLine(ex.Message)
End Try

' This code produces the following output:
' Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=a1Pass@@11
' Modified: Data Source = (local);Initial Catalog=AdventureWorks;Integrated Security=True

Comentarios

Dado que el método Remove devuelve un valor que indica que se ha realizado correctamente, no es necesario buscar una clave antes de intentar quitar el par clave-valor de la instancia de SqlConnectionStringBuilder. Dado que el SqlConnectionStringBuilder mantiene una colección de tamaño fijo de pares clave-valor, llamar al método Remove simplemente restablece el valor del par clave-valor a su valor predeterminado.

Dado que la colección de claves admitidas por el SqlConnectionStringBuilder es fija, cada elemento de la colección tiene un valor predeterminado conocido. En la tabla siguiente se enumeran las claves y el valor de cada una de las SqlConnectionStringBuilder se inicializa por primera vez, o después de llamar al método Remove.

Llave	Valor predeterminado
Nombre de la aplicación	".Net SqlClient Data Provider"
Procesamiento asincrónico	Falso
AttachDBFilename	Cadena vacía
Tiempo de espera de conexión	15
Conexión de contexto	Falso
Idioma actual	Cadena vacía
Origen de datos	Cadena vacía
Cifrar	Falso
Alistar	Verdadero
Asociado de conmutación por error	Cadena vacía
Catálogo inicial	Cadena vacía
Seguridad integrada	Falso
Tiempo de espera de equilibrio de carga	0
Tamaño máximo del grupo	100
Tamaño mínimo del grupo	0
MultipleActiveResultSets	Falso
Biblioteca de red	Cadena vacía
Tamaño del paquete	8000
Contraseña	Cadena vacía
Conservar información de seguridad	Falso
Agrupación	Verdadero
Replicación	Falso
Enlace de transacciones	Desenlace implícito
Id. de usuario	Cadena vacía
Instancia de usuario	Falso
Id. de estación de trabajo	Cadena vacía

Consulte también

• cadenas de conexión en ADO.NET
• información general de ADO.NET