Share via


OracleConnectionStringBuilder.Remove(String) Método

Definición

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

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

Excepciones

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

Se aplica a

Consulte también