OracleConnectionStringBuilder.Item[String] Propriedade

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Obtém ou define o valor associado à chave especificada. No C#, essa propriedade é o indexador.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

Parâmetros

keyword

String

A chave do item a ser obtida ou definida.

Valor da propriedade

Object

O valor associado à chave especificada.

Exceções

ArgumentNullException

keyword é uma referência nula (Nothing no Visual Basic).

KeyNotFoundException

Ocorreu uma tentativa de adicionar uma chave que não existe nas chaves disponíveis.

FormatException

Valor inválido na cadeia de conexão (especificamente, quando um valor numérico ou booliano era esperado, mas não foi fornecido).

Exemplos

O código a seguir, em um aplicativo de console, cria um novo OracleConnectionStringBuilder e adiciona pares chave/valor à sua cadeia de conexão, usando a Item[] propriedade .

// 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()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        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()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

Comentários

Como o OracleConnectionStringBuilder contém um dicionário de tamanho fixo, tentar adicionar uma chave que não existe dentro do dicionário lança um KeyNotFoundException. A tabela a seguir lista todas as chaves possíveis dentro do cadeia de conexão e o valor padrão para cada uma.

Chave	Propriedade	Valor padrão
Fonte de dados (ou servidor)	DataSource	cadeia de caracteres vazia
Persistir informações de segurança (ou persistsecurityinfo)	PersistSecurityInfo	Falso
Segurança Integrada	IntegratedSecurity	Falso
ID do usuário (ou usuário ou uid)	UserID	cadeia de caracteres vazia
Senha	Password	cadeia de caracteres vazia
Alistar	Enlist	Verdadeiro
Agrupamento	Pooling	Verdadeiro
Tamanho mínimo do pool	MinPoolSize	0
Tamanho Máx do Pool	MaxPoolSize	100
Omitir o Nome da Conexão Oracle	OmitOracleConnectionName	Falso
Unicode	Unicode	Falso
Tempo limite de balanceamento de carga (ou tempo de vida da conexão)	LoadBalanceTimeout	0

Confira também

• Criando cadeias de conexão