OracleConnection.ConnectionString Propriedade

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Obtém ou define a cadeia de caracteres usada para abrir um banco de dados Oracle.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Valor da propriedade

String

A cadeia de conexão do Oracle que inclui as configurações, como o nome do servidor, necessário para estabelecer a conexão inicial. O valor padrão é uma cadeia de caracteres vazia ("").

Atributos

SettingsBindableAttribute

Exemplos

O exemplo a seguir cria um OracleConnection e define algumas de suas propriedades no cadeia de conexão.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Comentários

O ConnectionString pode ser definido somente quando a conexão é fechada.

Você pode usar a ConnectionString propriedade para se conectar a um banco de dados. O exemplo a seguir ilustra um cadeia de conexão típico.

"Data Source=Oracle8i;Integrated Security=yes"  

Muitas das configurações especificadas na cadeia de caracteres têm propriedades somente leitura correspondentes (por exemplo, Data Source=MyServer, que corresponde à DataSource propriedade ). Quando o cadeia de conexão é definido, todas essas propriedades são atualizadas, a menos que um erro seja detectado; nesse caso, nenhuma das propriedades é atualizada. OracleConnection as propriedades retornam apenas as configurações padrão ou as configurações especificadas no ConnectionString.

Redefinir o ConnectionString em uma conexão fechada redefine todos os valores de cadeia de conexão (e propriedades relacionadas), incluindo a senha.

O cadeia de conexão é analisado imediatamente após ser definido. Se a análise revelar erros na sintaxe, uma exceção em tempo de execução, como ArgumentException, será gerada. Outros erros só podem ser encontrados quando é feita uma tentativa de abrir a conexão.

O formato básico de um cadeia de conexão é uma série de pares palavra-chave/valor separados por ponto e vírgula. O sinal de igual (=) conecta cada palavra-chave e seu valor. Para incluir valores que contenham ponto e vírgula, caractere de aspa única ou caractere de aspas duplas, o valor deve ser colocado entre aspas duplas. Se o valor contiver um ponto e vírgula e um caractere de aspas duplas, o valor poderá ser colocado entre aspas simples. A aspa simples também será útil se o valor começar com um caractere de aspas duplas. Por outro lado, a aspa dupla poderá ser usada se o valor começar com uma única aspa. Se o valor contiver caracteres de aspas simples e aspas duplas, o caractere de aspas usado para colocar o valor deve ser dobrado sempre que ocorrer dentro do valor.

Para incluir espaços anteriores ou à direita no valor da cadeia de caracteres, o valor deve ser colocado entre aspas simples ou aspas duplas. Todos os espaços à esquerda ou à direita em torno de valores inteiros, boolianos ou enumerados são ignorados, mesmo que entre aspas. No entanto, os espaços dentro de um literal de cadeia de caracteres palavra-chave ou valor são preservados. Aspas simples ou duplas podem ser usadas em uma cadeia de conexão sem usar delimitadores, a menos que um caractere de aspas seja o primeiro ou o último caractere no valor, por exemplo, Data Source= my'Server ou Data Source= my"Server.

Para incluir um sinal de igual (=) em um palavra-chave ou valor, ele deve ser precedido por outro sinal de igual. Por exemplo, na cadeia de conexão hipotética

"key==word=value"  

o palavra-chave é "key=word" e o valor é "value".

Se um palavra-chave específico em um par palavra-chave/valor ocorrer mais de uma vez em um cadeia de conexão, a última ocorrência será usada no conjunto de valores.

Palavras-chave não diferenciam maiúsculas de minúsculas.

A tabela a seguir lista os nomes válidos para valores dentro do ConnectionString.

Nome	Padrão	Descrição
Fonte de dados - ou - Servidor		O nome ou endereço de rede da instância do Oracle à qual se conectar.
Segurança Integrada	'false'	Se a conexão será ou não uma conexão segura. Os valores reconhecidos são true (altamente recomendados), false, yese no.
Senha		A senha da conta Oracle que está fazendo logon. Para manter um alto nível de segurança, é altamente recomendável que você use o palavra-chave de Segurança Integrada.
Informações de Persistência de Segurança	'false'	Quando definido false como ou no (altamente recomendado), informações confidenciais de segurança, como a senha, não serão retornadas como parte da conexão se a conexão estiver aberta ou se alguma vez estiver em um aberto State. Redefinir o cadeia de conexão redefine todos os valores cadeia de conexão, incluindo a senha. Os valores reconhecidos são true, false, yes e no.
Unicode	'false'	Especifica se o provedor de dados .NET Framework para Oracle usa chamadas à API do modo UTF16. Esse palavra-chave é ignorado, exceto ao usar o software cliente Oracle9i.
Id de Usuário		A conta de logon do Oracle. Para manter um alto nível de segurança, é altamente recomendável que você use o palavra-chave de Segurança Integrada.

A tabela a seguir lista os nomes válidos para valores de pooling de conexões dentro do ConnectionString.

Nome	Padrão	Descrição
Tempo de vida da conexão	0	Quando uma conexão é retornada para o pool, seu tempo de criação é comparado com a hora atual e a conexão será destruída se esse intervalo de tempo (em segundos) exceder o valor especificado por Connection Lifetime. Isso é útil nas configurações clusterizadas para forçar o balanceamento de carga entre um servidor em execução e um servidor que acabou de ficar online. Um valor zero faz com que as conexões em pool tenham o tempo limite máximo de conexão.
Alistar	'true'	Quando true ou yes, o pooler inscreve automaticamente a conexão no contexto de transação atual do thread de criação. Os valores reconhecidos são true, false, yes e no.
Tamanho Máx do Pool	100	O número máximo de conexões permitidas no pool. Definir o Max Pool Size valor do pode afetar o ConnectionString desempenho. Se você planeja criar e usar ativamente mais de 100 conexões, deverá aumentar Max Pool Size para um valor que se aproxima do uso de conexão de estado estável para o aplicativo.
Tamanho mínimo do pool	0	O número mínimo de conexões permitidas no pool.
Agrupamento	'true'	Quando true ou yes, o OracleConnection objeto é extraído do pool apropriado ou, se necessário, é criado e adicionado ao pool apropriado. Os valores reconhecidos são true, false, yes e no.

Ao definir palavra-chave ou valores de pooling de conexão que exigem um valor booliano, você pode usar 'yes' em vez de 'true' e 'no' em vez de 'false'. Valores inteiros são representados como cadeias de caracteres.