OracleConnectionStringBuilder.Remove(String) Método

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Remove a entrada com a chave especificada da instância 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

A chave do par chave/valor a ser removido da cadeia de conexão neste OracleConnectionStringBuilder.

Retornos

Boolean

true se a chave existia na cadeia de conexão e foi removida; false se a chave não existia.

Exceções

ArgumentNullException

keyword é nulo (Nothing no Visual Basic).

Exemplos

O exemplo a seguir converte um cadeia de conexão existente de usar a Autenticação do Windows em usando a segurança integrada. O exemplo funciona removendo o nome de usuário e a senha do cadeia de conexão e definindo a IntegratedSecurity propriedade do OracleConnectionStringBuilder objeto.

Observação

Este exemplo inclui uma senha para demonstrar como OracleConnectionStringBuilder funciona com cadeias de conexão. Em seus aplicativos, recomendamos que você use a Autenticação do Windows. Se você precisar usar uma senha, não inclua uma senha embutida em código em seu aplicativo.

// 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

Comentários

Como o Remove método retorna um valor que indica seu êxito, não é necessário procurar a existência de uma chave antes de tentar remover o par chave/valor da OracleConnectionStringBuilder instância. Como o OracleConnectionStringBuilder mantém uma coleção de tamanho fixo de pares chave/valor, chamar o Remove método apenas redefine o valor do par chave/valor de volta para seu valor padrão.

Como a coleção de chaves com suporte pelo OracleConnectionStringBuilder é fixa, cada item dentro da coleção tem um valor padrão conhecido.

A tabela a seguir lista as chaves e o valor de cada quando o OracleConnectionStringBuilder é inicializado pela primeira vez ou após o Remove método ter sido chamado:

Chave	Valor padrão
fonte de dados	cadeia de caracteres vazia
Informações de Persistência de Segurança	Falso
Segurança Integrada	Falso
Id de Usuário	cadeia de caracteres vazia
Senha	cadeia de caracteres vazia
Alistar	Verdadeiro
Agrupamento	Verdadeiro
Tamanho mínimo do pool	0
Tamanho Máx do Pool	100
Unicode	Falso
Tempo limite do balanceamento de carga	0
Omitir o nome da conexão oracle	Falso

Confira também

• Criando cadeias de conexão