OracleConnectionStringBuilder Classe

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Cuidado

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Fornece uma maneira simples de criar e gerenciar o conteúdo das cadeias de conexão usadas pela classe OracleConnection.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Herança

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Atributos

TypeConverterAttribute ObsoleteAttribute

Comentários

Esse tipo foi preterido e será removido em uma versão futura do .NET Framework. Para obter mais informações, consulte Oracle e ADO.NET.

Os construtores de cadeias de conexão permitem que os desenvolvedores criem programaticamente cadeias de conexão sintaticamente corretas e analisem e recompilem cadeias de conexão existentes, usando propriedades e métodos da classe. O construtor de cadeias de conexão fornece propriedades fortemente tipadas correspondentes aos pares chave/valor conhecidos permitidos pela Oracle. A classe OracleConnectionStringBuilder implementa a interface ICustomTypeDescriptor. Isso significa que a classe funciona com designers .NET do Visual Studio em tempo de design. Quando os desenvolvedores usam o designer para criar dataSets fortemente tipados e conexões fortemente tipadas no Visual Studio .NET, a classe construtor de cadeias de conexão fortemente tipada exibirá as propriedades associadas ao seu tipo e também terá conversores que podem mapear valores comuns para chaves conhecidas.

Os desenvolvedores que precisam criar cadeias de conexão como parte dos aplicativos podem usar a classe OracleConnectionStringBuilder para criar e modificar cadeias de conexão. A classe OracleConnectionStringBuilder também facilita o gerenciamento de cadeias de conexão armazenadas em um arquivo de configuração de aplicativo.

O OracleConnectionStringBuilder executa verificações de pares chave/valor válidos. Portanto, essa classe não pode ser usada para criar cadeias de conexão inválidas. Tentar adicionar pares inválidos gerará uma exceção. A classe OracleConnectionStringBuilder mantém uma coleção fixa de sinônimos e, quando necessário, pode executar a tradução necessária para converter de um sinônimo para o nome de chave conhecido correspondente. Por exemplo, ao usar a propriedade Item[] para recuperar um valor, você pode especificar uma cadeia de caracteres que contenha qualquer sinônimo para a chave necessária. Consulte a propriedade Item[] para obter uma lista completa de sinônimos aceitáveis.

O OracleConnectionStringBuilder manipula tentativas de inserir entradas mal-intencionadas. Por exemplo, o código a seguir, usando a propriedade Item[] padrão (o indexador, em C#), escapa corretamente do par chave/valor aninhado.

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
builder("Integrated Security") = True
builder("User ID") = "Mary;NewValue=Bad"
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)

System.Data.OracleClient.OracleConnectionStringBuilder builder =
   new System.Data.OracleClient.OracleConnectionStringBuilder();
builder["Data Source"] = "OracleDemo";
builder["integrated Security"] = true;
builder["User ID"] = "Mary;NewValue=Bad";
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

O resultado é a seguinte cadeia de conexão que manipula o valor inválido de maneira segura, colocando o valor da ID do usuário entre aspas:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"

Aviso

A Microsoft não recomenda fornecer seu nome de usuário e senha diretamente, pois é um padrão inseguro. Sempre que possível, use fluxos de autenticação mais seguros, como Identidades Gerenciadas para recursos do Azureou de autenticação do Windows para SQL Server.

Construtores

OracleConnectionStringBuilder()	Obsoleto. Inicializa uma nova instância da classe OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Obsoleto. Inicializa uma nova instância da classe OracleConnectionStringBuilder. A cadeia de conexão fornecida fornece os dados para as informações de conexão interna da instância.

Propriedades

BrowsableConnectionString	Obsoleto. Obtém ou define um valor que indica se a propriedade ConnectionString está visível em designers do Visual Studio. (Herdado de DbConnectionStringBuilder)
ConnectionString	Obsoleto. Obtém ou define a cadeia de conexão associada ao DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
Count	Obsoleto. Obtém o número atual de chaves contidas na propriedade ConnectionString. (Herdado de DbConnectionStringBuilder)
DataSource	Obsoleto. Obtém ou define o nome da fonte de dados Oracle à qual se conectar.
Enlist	Obsoleto. Obtém ou define um valor que indica se o pooler inseri automaticamente a conexão no contexto de transação atual do thread de criação.
IntegratedSecurity	Obsoleto. Obtém ou define um valor que indica se "ID de Usuário" e "Senha" são especificados na conexão (quando false) ou se as credenciais atuais da conta do Windows são usadas para autenticação (quando true).
IsFixedSize	Obsoleto. Obtém um valor que indica se o OracleConnectionStringBuilder tem um tamanho fixo.
IsReadOnly	Obsoleto. Obtém um valor que indica se o DbConnectionStringBuilder é somente leitura. (Herdado de DbConnectionStringBuilder)
Item[String]	Obsoleto. Obtém ou define o valor associado à chave especificada. Em C#, essa propriedade é o indexador.
Keys	Obsoleto. Obtém um ICollection que contém as chaves no OracleConnectionStringBuilder.
LoadBalanceTimeout	Obsoleto. Obtém ou define o tempo mínimo, em segundos, para que a conexão resida no pool de conexões antes de ser removida.
MaxPoolSize	Obsoleto. Obtém ou define o número máximo de conexões permitidas no pool de conexões para essa cadeia de conexão específica.
MinPoolSize	Obsoleto. Obtém ou define o número mínimo de conexões permitidas no pool de conexões para essa cadeia de conexão específica.
OmitOracleConnectionName	Obsoleto. Obtém ou define o sinalizador que permite reversões de transação em versões anteriores do Oracle (antes da 8.1.7.4.1).
Password	Obsoleto. Obtém ou define a senha da conta Oracle.
PersistSecurityInfo	Obsoleto. Obtém ou define um valor booliano que indica se informações confidenciais de segurança, como a senha, não são retornadas como parte da conexão se a conexão estiver aberta ou se alguma vez estiver em um estado aberto.
Pooling	Obsoleto. Obtém ou define um valor booliano que indica se a conexão será agrupada ou se cada conexão será aberta explicitamente sempre que a conexão for solicitada.
Unicode	Obsoleto. Obtém ou define um valor booliano que indica se o cliente dá suporte à funcionalidade Unicode disponível em clientes Oracle posteriores ou se não está ciente do Unicode.
UserID	Obsoleto. Obtém ou define a ID do usuário a ser usada ao se conectar ao Oracle.
Values	Obsoleto. Obtém um ICollection que contém os valores no OracleConnectionStringBuilder.

Métodos

Add(String, Object)	Obsoleto. Adiciona uma entrada com a chave e o valor especificados ao DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
Clear()	Obsoleto. Limpa o conteúdo da instância de OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Obsoleto. Limpa a coleção de objetos PropertyDescriptor no DbConnectionStringBuilderassociado. (Herdado de DbConnectionStringBuilder)
ContainsKey(String)	Obsoleto. Determina se o OracleConnectionStringBuilder contém uma chave específica.
Equals(Object)	Obsoleto. Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
EquivalentTo(DbConnectionStringBuilder)	Obsoleto. Compara as informações de conexão neste objeto DbConnectionStringBuilder com as informações de conexão no objeto fornecido. (Herdado de DbConnectionStringBuilder)
GetHashCode()	Obsoleto. Serve como a função de hash padrão. (Herdado de Object)
GetProperties(Hashtable)	Obsoleto. Preenche um Hashtable fornecido com informações sobre todas as propriedades deste DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
GetType()	Obsoleto. Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Obsoleto. Cria uma cópia superficial do Objectatual. (Herdado de Object)
Remove(String)	Obsoleto. Remove a entrada com a chave especificada da instância de OracleConnectionStringBuilder.
ShouldSerialize(String)	Obsoleto. Indica se a chave especificada existe nesta instância OracleConnectionStringBuilder.
ToString()	Obsoleto. Retorna a cadeia de conexão associada a esse DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
TryGetValue(String, Object)	Obsoleto. Recupera um valor correspondente à chave fornecida deste OracleConnectionStringBuilder.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Obsoleto. Copia os elementos do ICollection para um Array, começando em um índice Array específico. (Herdado de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obsoleto. Obtém um valor que indica se o acesso ao ICollection é sincronizado (thread safe). (Herdado de DbConnectionStringBuilder)
ICollection.SyncRoot	Obsoleto. Obtém um objeto que pode ser usado para sincronizar o acesso ao ICollection. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Obsoleto. Retorna uma coleção de atributos personalizados para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Obsoleto. Retorna o nome da classe dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Obsoleto. Retorna o nome dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Obsoleto. Retorna um conversor de tipo para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Obsoleto. Retorna o evento padrão para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Obsoleto. Retorna a propriedade padrão para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Obsoleto. Retorna um editor do tipo especificado para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Obsoleto. Retorna os eventos para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Obsoleto. Retorna os eventos dessa instância de um componente usando a matriz de atributo especificada como um filtro. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Obsoleto. Retorna as propriedades dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Obsoleto. Retorna as propriedades dessa instância de um componente usando a matriz de atributos como um filtro. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Obsoleto. Retorna um objeto que contém a propriedade descrita pelo descritor de propriedade especificado. (Herdado de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Obsoleto. Adiciona um elemento com a chave e o valor fornecidos ao objeto IDictionary. (Herdado de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Obsoleto. Determina se o objeto IDictionary contém um elemento com a chave especificada. (Herdado de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Obsoleto. Retorna um objeto IDictionaryEnumerator para o objeto IDictionary. (Herdado de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obsoleto. Obtém ou define o elemento com a chave especificada. (Herdado de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Obsoleto. Remove o elemento com a chave especificada do objeto IDictionary. (Herdado de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Obsoleto. Retorna um enumerador que itera por meio de uma coleção. (Herdado de DbConnectionStringBuilder)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Obsoleto. Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Obsoleto. Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Obsoleto. Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Obsoleto. Converte um IEnumerable em um IQueryable.

Confira também

• criando cadeias de conexão