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

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

Implementações

Atributos

SettingsBindableAttribute

Observações

Só ConnectionString podem ser definidos quando a ligação está fechada.

Pode usar a ConnectionString propriedade para se ligar a uma base de dados.

Muitas das definições especificadas na cadeia têm propriedades correspondentes de apenas leitura (por exemplo, Data Source=MyServer, que corresponde à DataSource propriedade). Quando a cadeia de ligação é definida, todas estas propriedades são atualizadas, a menos que seja detetado um erro, caso em que nenhuma das propriedades é atualizada. OracleConnection As propriedades retornam apenas as definições por defeito, ou aquelas especificadas no ConnectionStringarquivo .

Reiniciar o ConnectionString numa ligação fechada reinicia todos os valores cadeia de ligação (e propriedades relacionadas), incluindo a palavra-passe.

A cadeia de ligação é analisada imediatamente após ser definida. Se a análise revelar erros na sintaxe, gera-se uma exceção em tempo de execução, como ArgumentException, Outros erros só podem ser encontrados quando se tenta abrir a ligação.

O formato básico de uma cadeia de ligação é uma série de pares palavra-chave/valor separados por pontos e vírgula. O sinal de igual (=) liga cada palavra-chave ao seu valor. Para incluir valores que contenham um carácter de ponto e vírgula, aspas simples ou aspas duplas, o valor deve estar incluído entre aspas duplas. Se o valor contiver tanto um ponto e vírgula como um carácter de aspas duplas, o valor pode ser incluído entre aspas simples. A aspas simples também é útil se o valor começar com um carácter de aspas duplas. Por outro lado, a dupla aspas pode ser usada se o valor começar com uma única citação. Se o valor contiver caracteres de aspas simples e duplas, o carácter usado para envolver o valor deve ser duplicado cada vez que este ocorre dentro do valor.

Para incluir espaços anteriores ou finais no valor da cadeia, o valor deve ser incluído entre aspas simples ou duplas. Quaisquer espaços iniciais ou finais em torno de valores inteiros, booleanos ou enumerados são ignorados, mesmo que estejam entre aspas. No entanto, os espaços dentro de uma palavra-chave ou valor literal são preservados. Aspas simples ou duplas podem ser usadas dentro de um cadeia de ligação sem usar delimitadores, a menos que um carácter entre aspas seja o primeiro ou último carácter do valor, por exemplo, Data Source= my'Server ou Data Source= my"Server.

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

"key==word=value"

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

Se uma palavra-chave específica num par palavra-chave/valor ocorrer mais do que uma vez numa cadeia de ligação, a última ocorrência é usada no conjunto de valores.

As palavras-chave não distinguem minúsculas e maiúsculas.

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

A tabela seguinte lista os nomes válidos para valores de agrupamento de ligações dentro do ConnectionString.

Ao definir valores de pooling de palavras-chave ou de ligação que exigem um valor booleano, pode usar 'sim' em vez de 'verdadeiro' e 'não' em vez de 'falso'. Os valores inteiros são representados como cadeias.