OracleConnection.ConnectionString 속성

참조

정의

네임스페이스:: System.Data.OracleClient

어셈블리:: System.Data.OracleClient.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Oracle 데이터베이스를 여는 데 사용되는 문자열을 가져오거나 설정합니다.

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

속성 값

String

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

구현

ConnectionString

특성: SettingsBindableAttribute

예제

다음 예제에서는 을 OracleConnection 만들고 연결 문자열 해당 속성 중 일부를 설정합니다.

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

설명

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

속성을 사용하여 ConnectionString 데이터베이스에 연결할 수 있습니다. 다음 예제에서는 일반적인 연결 문자열 보여 줍니다.

"Data Source=Oracle8i;Integrated Security=yes"

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

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

연결 문자열 설정된 직후 구문 분석됩니다. 구문 분석에서 오류가 표시되면 와 같은 ArgumentException런타임 예외가 생성됩니다. 다른 오류는 연결을 열려고 시도한 경우에만 찾을 수 있습니다.

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

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

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

"key==word=value"

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

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

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

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

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

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

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

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

적용 대상

다음을 통해 공유

OracleConnection.ConnectionString 속성

정의

속성 값

구현

예제

설명

적용 대상

추가 리소스