SqlConnectionStringBuilder.Remove(String) Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

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 de clave-valor que se va a quitar de la cadena de conexión en este SqlConnectionStringBuilder.

Devoluciones

Boolean

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

Excepciones

ArgumentNullException

keyword es nulo (Nothing en Visual Basic).

Ejemplos

En el ejemplo siguiente una cadena de conexión existente pasa de utilizar autenticación de Windows a utilizar seguridad integrada. El ejemplo funciona quitando el nombre de usuario y la contraseña de la cadena de conexión y, a continuación, estableciendo la propiedad IntegratedSecurity del objeto SqlConnectionStringBuilder.

Nota

Este ejempo incluye una contraseña para demostrar cómo SqlConnectionStringBuilder funciona con cadenas de conexión. Se recomienda que utilice autenticación de Windows en sus aplicaciones. Si necesita utilizar una contraseña en su aplicación, no incluya una contraseña codificada de forma rígida.

using System.Data.SqlClient;

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

            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Use the Remove method
            // in order to reset the user ID and password back to their
            // default (empty string) values.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Turn on integrated security:
            builder.IntegratedSecurity = true;

            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection
                       connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

Imports System.Data.SqlClient
    
Module Module1
  Sub Main()
    Try
      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)

      ' Use the Remove method
      ' in order to reset the user ID and password back to their
      ' default (empty string) values.
      builder.Remove("User ID")
      builder.Remove("Password")

      ' Turn on integrated security:
      builder.IntegratedSecurity = True

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

      Using connection As New SqlConnection(builder.ConnectionString)
        connection.Open()
        ' Now use the open connection.
        Console.WriteLine("Database = " & connection.Database)
      End Using

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

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  End Sub
End Module

El ejemplo muestra el texto siguiente en la ventana de consola:

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password= a1Pass@@11
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
Database = AdventureWorks

Comentarios

Dado que el método Remove devuelve un valor que indica su éxito, no es necesario buscar una clave antes de intentar quitar el par clave-valor de la SqlConnectionStringBuilder instancia. Ya que SqlConnectionStringBuilder mantiene una colección de tamaño fijo de pares clave-valor, llamando al método Remove restablece el valor del par clave-valor en su valor predeterminado.

Ya que la colección de claves compatibles con SqlConnectionStringBuilder es fija, cada elemento de la colección tiene un valor predeterminado conocido. La tabla siguiente enumera las claves y el valor de cada una cuanto se inicializa SqlConnectionStringBuilder por primera vez o después de llamar al método Remove.

Clave	Valor predeterminado
Nombre de la aplicación	".Net SqlClient Data Provider"
Procesamiento asincrónico	Falso
AttachDBFilename	cadena vacía.
Tiempo de espera de la conexión	15
Conexión de contexto	Falso
Idioma actual	cadena vacía.
Origen de datos	cadena vacía.
Cifrado	Falso
Dar de alta	Verdadero
Failover Partner	cadena vacía.
Catálogo original	cadena vacía.
Seguridad integrada	Falso
Tiempo de espera de equilibrio de carga	0
Max Pool Size	100
Min Pool Size	0
MultipleActiveResultSets	Falso
Biblioteca de red	cadena vacía.
Tamaño del paquete	8000
Contraseña	cadena vacía.
Persist Security Info	Falso
Agrupación	Verdadero
Replicación	Falso
Enlace por 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 de ADO.NET
• Información general de ADO.NET