OracleConnection.ConnectionString 속성

정의

네임스페이스:

System.Data.OracleClient

어셈블리:

System.Data.OracleClient.dll

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

속성 값

String

초기 연결을 설정하는 데 필요한 서버 이름과 같은 설정을 포함하는 Oracle 연결 문자열입니다. 기본값은 빈 문자열("")입니다.

특성

SettingsBindableAttribute

설명

연결이 ConnectionString 닫힌 경우에만 설정할 수 있습니다.

이 속성을 사용하여 ConnectionString 데이터베이스에 연결할 수 있습니다.

문자열에 지정된 대부분의 설정에는 해당 읽기 전용 속성(예: Data Source=MyServer속성에 해당)이 DataSource 있습니다. 연결 문자열이 설정되면 오류가 검색되지 않는 한 이러한 모든 속성이 업데이트되며, 이 경우 속성은 업데이트되지 않습니다. OracleConnection 속성은 기본 설정 또는 에 지정된 ConnectionString설정만 반환합니다.

닫힌 연결에서 ConnectionString 다시 설정하면 암호를 포함한 모든 연결 문자열 값(및 관련 속성)이 다시 설정됩니다.

연결 문자열은 설정된 직후 구문 분석됩니다. 구문 분석 시 오류가 표시되면 런타임 예외(예: ArgumentException)가 생성됩니다. 다른 오류는 연결을 열려고 할 때만 찾을 수 있습니다.

연결 문자열의 기본 형식은 세미콜론으로 구분된 일련의 키워드/값 쌍입니다. 등호(=)는 각 키워드와 해당 값을 연결합니다. 세미콜론, 작은따옴표 문자 또는 큰따옴표 문자를 포함하는 값을 포함하려면 값을 큰따옴표로 묶어야 합니다. 값에 세미콜론과 큰따옴표 문자가 모두 포함된 경우 값을 작은따옴표로 묶을 수 있습니다. 작은따옴표는 값이 큰따옴표 문자로 시작하는 경우에도 유용합니다. 반대로 값이 작은따옴표로 시작하는 경우 큰따옴표를 사용할 수 있습니다. 값에 작은따옴표와 큰따옴표 문자가 모두 포함된 경우 값을 묶는 데 사용되는 따옴표 문자는 값 내에서 발생할 때마다 두 배가 되어야 합니다.

문자열 값에 앞 또는 후행 공백을 포함하려면 값을 작은따옴표 또는 큰따옴표로 묶어야 합니다. 따옴표로 묶어도 정수, 부울 또는 열거형 값 주위의 선행 또는 후행 공백은 무시됩니다. 그러나 문자열 리터럴 키워드 또는 값 내의 공백은 유지됩니다. 예를 들어 Data Source= my'Server 따옴표 문자가 값의 첫 번째 또는 마지막 문자가 아니면 구분 기호를 사용하지 않고 연결 문자열 내에서 작은따옴표나 Data Source= my"Server큰따옴표를 사용할 수 있습니다.

키워드 또는 값에 등호(=)를 포함하려면 다른 등호 앞에 와야 합니다. 예를 들어 가상 연결 문자열

"key==word=value"

키워드는 "key=word"이고 값은 "value"입니다.

연결 문자열에서 키워드/값 쌍의 특정 키워드가 두 번 이상 발생하는 경우 값 집합에서 마지막 항목이 사용됩니다.

키워드는 대/소문자를 구분하지 않습니다.

다음 표에는 . 내의 값에 대한 유효한 이름이 나와 있습니다 ConnectionString.

이름	기본값	설명
데이터 원본 -또는- 서버		연결할 Oracle 인스턴스의 이름 또는 네트워크 주소입니다.
통합 보안	'false'	연결이 보안 연결인지 여부입니다. 인식된 값은 true (강력하게 권장), false및 yesno.
암호		Oracle 계정 로그온에 대한 암호입니다. 높은 수준의 보안을 유지하려면 대신 통합 보안 키워드를 사용하는 것이 좋습니다.
보안 정보 유지	'false'	false 연결이 열려 있거나 no 열려 State있는 경우 암호와 같은 보안에 중요한 정보가 연결의 일부로 반환되지 않습니다. 연결 문자열을 다시 설정하면 암호를 포함한 모든 연결 문자열 값이 다시 설정됩니다. 인식되는 값은 true, false, yes 및 no입니다.
Unicode	'false'	.NET Framework Data Provider for Oracle에서 UTF16 모드 API 호출을 사용하는지 여부를 지정합니다. Oracle9i 클라이언트 소프트웨어를 사용하는 경우를 제외하고 이 키워드는 무시됩니다.
사용자 ID		Oracle 로그인 계정입니다. 높은 수준의 보안을 유지하려면 대신 통합 보안 키워드를 사용하는 것이 좋습니다.

다음 표에서는 내의 연결 풀링 값에 대한 유효한 이름을 나열합니다 ConnectionString.

이름	기본값	설명
연결 수명	0	연결이 풀로 반환되면 연결을 만든 시간을 현재 시간과 비교하여 이 시간 간격(초)이 Connection Lifetime에서 지정한 값을 초과하는 경우 연결이 제거됩니다. 이는 클러스터링된 구성에서 실행 중인 서버와 방금 온라인 상태가 된 서버 사이에 로드 균형 조정을 강제로 조정하는 데 유용합니다. 값이 0이면 풀된 연결이 최대 연결 제한 시간을 갖게 됩니다.
등록	'true'	yes또는true, 풀러가 생성 스레드의 현재 트랜잭션 컨텍스트에서 연결을 자동으로 등록합니다. 인식되는 값은 true, false, yes 및 no입니다.
최대 풀 크기	100	풀에서 허용되는 최대 연결 수입니다. 값을 설정하면 Max Pool Size 성능에 ConnectionString 영향을 줄 수 있습니다. 100개 이상의 연결을 만들고 적극적으로 사용하려는 경우 애플리케이션에 대한 안정적인 상태 연결 사용량을 근사값으로 늘려 Max Pool Size 야 합니다.
최소 풀 크기	0	풀에서 허용되는 최소 연결 수입니다.
자원 결합	'true'	true yes개체가 OracleConnection 적절한 풀에서 그려지는 경우 또는 필요한 경우 만들어지고 적절한 풀에 추가됩니다. 인식되는 값은 true, false, yes 및 no입니다.

부울 값이 필요한 키워드 또는 연결 풀링 값을 설정할 때는 'true' 대신 'yes'를, 'false' 대신 'no'를 사용할 수 있습니다. 정수 값은 문자열로 표시됩니다.