OracleConnectionStringBuilder.Remove(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
true
se a chave existia na cadeia de conexão e foi removida; false
se a chave não existia.
Exceções
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 |