OracleConnection.ConnectionString Propriedade

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

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

public string ConnectionString { get; set; }

public override string ConnectionString { get; set; }

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

member this.ConnectionString : string with get, set

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

Public Property ConnectionString As String

Public Overrides Property ConnectionString As String

Valor da propriedade

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

Implementações

Atributos

SettingsBindableAttribute

Comentários

A ConnectionString conexão só pode ser definida quando a conexão é fechada.

Você pode usar a ConnectionString propriedade para se conectar a um banco de dados.

Muitas das configurações especificadas na cadeia de caracteres têm propriedades somente leitura correspondentes (por exemplo, Data Source=MyServerque corresponde à DataSource propriedade). Quando a cadeia de conexão é definida, 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 em ConnectionString uma conexão fechada redefine todos os valores de cadeia de conexão (e propriedades relacionadas), incluindo a senha.

A cadeia de conexão é analisada imediatamente após ser definida. 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 uma cadeia de conexão é uma série de pares de palavra-chave/valor separados por ponto-e-vírgula. O sinal de igual (=) conecta cada palavra-chave e seu valor. Para incluir valores que contêm um ponto-e-vírgula, um caractere de aspa única ou um caractere de aspas dupla, 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 única 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 aspa única e de aspas duplas, o caractere de aspas usado para colocar o valor deve ser duplicado 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 uma palavra-chave ou valor literal de cadeia de caracteres 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 uma 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"

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

Se uma palavra-chave específica em um par de palavras-chave/valor ocorrer mais de uma vez em uma 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 de ConnectionString.

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

Ao definir a palavra-chave ou os valores de pool de conexão que exigem um valor booliano, você pode usar "sim" em vez de "true" e "não" em vez de "false". Valores inteiros são representados como cadeias de caracteres.