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

Exemplos

O aplicativo de console a seguir cria cadeias de conexão para um banco de dados Oracle. O código usa uma OracleConnectionStringBuilder classe para criar o cadeia de conexão e, em seguida, passa a ConnectionString propriedade da OracleConnectionStringBuilder instância para o construtor da classe de conexão. O exemplo também analisa um cadeia de conexão existente e demonstra várias maneiras de manipular o conteúdo do cadeia de conexão.

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()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

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 cadeia 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 cadeia de conexão fornece propriedades fortemente tipada correspondentes aos pares chave/valor conhecidos permitidos pelo 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 Conjuntos de Dados fortemente tipados e conexões fortemente tipadas no Visual Studio .NET, a classe de construtor de cadeia 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 OracleConnectionStringBuilder classe para criar e modificar cadeias de conexão. A OracleConnectionStringBuilder classe 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 OracleConnectionStringBuilder classe 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 Item[] propriedade para recuperar um valor, você pode especificar uma cadeia de caracteres que contenha qualquer sinônimo para a chave necessária. Consulte a Item[] propriedade 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 padrão Item[] (o indexador, em C#) escapa corretamente do par chave/valor aninhado.

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

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 é o seguinte cadeia de conexão que manipula o valor inválido de maneira segura colocando o valor da ID de Usuário entre aspas:

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

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 oferece os dados para obter informações de conexão internas da instância.

Propriedades

BrowsableConnectionString	Obsoleto. Obtém ou define um valor que indica se a propriedade ConnectionString é visível nos designers do Visual Studio. (Herdado de DbConnectionStringBuilder)
ConnectionString	Obsoleto. Obtém ou define a cadeia de conexão associada a 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 inscreve 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 a “ID de Usuário” e a “Senha” são especificadas 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. No 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 a conexão permanecer no pool de conexão antes de ser removida.
MaxPoolSize	Obsoleto. Obtém ou define o número máximo de conexões permitido no pool de conexão para essa cadeia de conexão específica.
MinPoolSize	Obsoleto. Obtém ou define o número mínimo de conexões permitido no pool de conexão para essa cadeia de conexão específica.
OmitOracleConnectionName	Obsoleto. Obtém ou define o sinalizador que habilita 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 para a 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 serão retornadas como parte da conexão se ela estiver aberta ou se já esteve em um estado aberto.
Pooling	Obsoleto. Obtém ou define um valor booliano que indica se a conexão será agrupada em pool 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 é compatível com a funcionalidade Unicode disponível em clientes Oracle posteriores ou se ele não detecta Unicode.
UserID	Obsoleto. Obtém ou define a ID de usuário a ser usada ao conectar-se 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 OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Obsoleto. Limpa a coleção de objetos PropertyDescriptor no DbConnectionStringBuilder associado. (Herdado de DbConnectionStringBuilder)
ContainsKey(String)	Obsoleto. Determina se a 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 Object atual. (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 nessa 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 para a 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 determinado índice Array. (Herdado de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obsoleto. Obtém um valor que indica se o acesso à 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 de classe desta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Obsoleto. Retorna o nome desta 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 desta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Obsoleto. Retorna os eventos desta instância de um componente usando a matriz de atributos especificada como um filtro. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Obsoleto. Retorna as propriedades desta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Obsoleto. Retorna as propriedades desta 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 em 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