Partilhar via


OracleConnectionStringBuilder.Item[String] Propriedade

Definição

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

O valor associado à chave especificada.

Exceções

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

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

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

Aplica-se a

Confira também