OracleConnectionStringBuilder.Remove(String) Método

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

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

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 OracleConnectionStringBuilder.

Devoluciones

Boolean

true si la clave se encuentra en la cadena de conexión y se quita, false si la clave no existe.

Excepciones

ArgumentNullException

keyword es null (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 OracleConnectionStringBuilder.

Nota

Este ejempo incluye una contraseña para demostrar cómo OracleConnectionStringBuilder 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.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=OracleDemo;User ID=Mary;Password=*****";

            OracleConnectionStringBuilder builder = new OracleConnectionStringBuilder(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);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1

  Sub Main()
    Try
      Dim connectString As String = _
       "Data Source=OracleDemo;User ID=Mary;Password=*****;"

      Dim builder As New OracleConnectionStringBuilder(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)

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

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

Comentarios

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

Ya que la colección de claves compatibles con OracleConnectionStringBuilder 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 ellas cuando OracleConnectionStringBuilder se inicializa por primera vez o después de llamar al Remove método :

Clave	Valor predeterminado
Origen de datos	cadena vacía.
Persist Security Info	Falso
Seguridad integrada	Falso
Id. de usuario	cadena vacía.
Contraseña	cadena vacía.
Dar de alta	Verdadero
Agrupación	Verdadero
Min Pool Size	0
Max Pool Size	100
Unicode	Falso
Tiempo de espera de equilibrio de carga	0
Omitir el nombre de conexión de Oracle	Falso

Consulte también

• Creación de cadenas de conexión