다음을 통해 공유


OracleConnectionStringBuilder 클래스

정의

주의

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

OracleConnection 클래스에서 사용하는 연결 문자열의 내용을 손쉽게 만들고 관리할 수 있는 방법을 제공합니다.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder
상속
OracleConnectionStringBuilder
특성

예제

다음 콘솔 애플리케이션에는 Oracle 데이터베이스에 대 한 연결 문자열 작성합니다. 코드를 사용 하 여는 OracleConnectionStringBuilder 클래스를 연결 문자열을 만들고 전달 됩니다는 ConnectionString 의 속성을 OracleConnectionStringBuilder connection 클래스의 인스턴스 생성자를 합니다. 또한 기존 연결 문자열을 구문 분석 하 고 연결 문자열의 내용을 조작 하는 여러 가지 방법을 보여 줍니다.

참고

이 예제에는 OracleConnectionStringBuilder가 연결 문자열로 작업하는 방법을 보여 주기 위한 암호가 포함되어 있습니다. 애플리케이션에서는 Windows 인증을 사용하는 것이 좋습니다. 암호를 사용해야 하는 경우에는 애플리케이션에 하드 코드된 암호를 포함하지 마십시오.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}
' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

설명

이 형식은 사용 되지 않으며.NET Framework의 이후 버전에서 제거 됩니다. 자세한 내용은 Oracle 및 ADO.NET합니다.

연결 문자열 작성기 클래스의 메서드와 속성을 사용 하 여 개발자가 프로그래밍 방식으로 만드는 구문이 올바른 연결 문자열 및 문자열 구문 분석 하 고 기존 연결을 다시 작성에 허용 합니다. 연결 문자열 작성기 Oracle에서 허용 되는 알려진된 키/값 쌍에 해당 하는 강력한 형식의 속성을 제공 합니다. OracleConnectionStringBuilder 클래스가 ICustomTypeDescriptor 인터페이스를 구현합니다. 이 클래스 디자인 타임에 Visual Studio.NET 디자이너를 사용 하 여 작동 한다는 것을 의미 합니다. 개발자가 디자이너를 사용하여 Visual Studio .NET 내에서 강력한 형식의 DataSets 및 강력한 형식의 연결을 빌드하는 경우 강력한 형식의 연결 문자열 작성기 클래스는 해당 형식과 연결된 속성을 표시하고 알려진 키에 대한 공통 값을 매핑할 수 있는 변환기도 갖습니다.

애플리케이션에서 연결 문자열을 만들어야 하는 개발자는 OracleConnectionStringBuilder 클래스를 사용하여 연결 문자열을 빌드하고 수정할 수 있습니다. OracleConnectionStringBuilder 클래스도 쉽게 애플리케이션 구성 파일에 저장 된 연결 문자열을 관리 합니다.

OracleConnectionStringBuilder는 키/값 쌍에 대한 유효성을 검사하기 때문에 따라서 잘못 된 연결 문자열을 만들려면이 클래스를 사용할 수 없습니다. 잘못 된 쌍을 추가 하려고 하면 예외가 throw 됩니다. OracleConnectionStringBuilder 클래스는 고정 된 동의어, 컬렉션을 유지 관리 하 고 필요한 경우에 해당 하는 잘 알려진 키 이름으로 동의어 변환할 필요한 번역을 수행할 수 있습니다. 예를 들어, 사용 하는 경우는 Item[] 속성 값을 검색 해야 하는 키에 대 한 동의어가 포함 된 문자열을 지정할 수 있습니다. 허용 가능한 동의어의 전체 목록은 Item[] 속성을 참조하십시오.

OracleConnectionStringBuilder 악의적 항목을 삽입 하려는 시도 처리 합니다. 예를 들어, 다음을 사용 하는 코드 기본 Item[] 속성 (C# 인덱서)에 중첩 된 키/값 쌍을 올바르게 이스케이프 합니다.

Dim builder As New System.Data. _  
    OracleClient.OracleConnectionStringBuilder  
builder("Data Source") = "OracleDemo"  
builder("Integrated Security") = True  
builder("User ID") = "Mary;NewValue=Bad"  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)  
System.Data.OracleClient.OracleConnectionStringBuilder builder =  
   new System.Data.OracleClient.OracleConnectionStringBuilder();  
builder["Data Source"] = "OracleDemo";  
builder["integrated Security"] = true;  
builder["User ID"] = "Mary;NewValue=Bad";  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);  

결과 사용자 ID 값을 따옴표로 묶어를 안전한 방식으로 잘못 된 값을 처리 하는 다음 연결 문자열:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"  

생성자

OracleConnectionStringBuilder()
사용되지 않음.

OracleConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다.

OracleConnectionStringBuilder(String)
사용되지 않음.

OracleConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. 제공된 연결 문자열에서는 인스턴스의 내부 연결 정보에 대한 데이터를 제공합니다.

속성

BrowsableConnectionString
사용되지 않음.

ConnectionString 속성이 Visual Studio 디자이너에서 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ConnectionString
사용되지 않음.

DbConnectionStringBuilder와 연결된 연결 문자열을 가져오거나 설정합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
Count
사용되지 않음.

ConnectionString 속성 내에 포함된 키의 현재 수를 가져옵니다.

(다음에서 상속됨 DbConnectionStringBuilder)
DataSource
사용되지 않음.

연결할 Oracle 데이터 소스의 이름을 가져오거나 설정합니다.

Enlist
사용되지 않음.

풀러가 만들기 스레드의 현재 트랜잭션 컨텍스트에 연결을 자동으로 참여시키는지 여부를 나타내는 값을 가져오거나 설정합니다.

IntegratedSecurity
사용되지 않음.

"User ID"와 "Password"가 연결에 지정되어 있는지(false인 경우) 아니면 현재 Windows 계정 자격 증명이 인증에 사용되는지(true인 경우)를 나타내는 값을 가져오거나 설정합니다.

IsFixedSize
사용되지 않음.

OracleConnectionStringBuilder의 크기가 고정되어 있는지 여부를 나타내는 값을 가져옵니다.

IsReadOnly
사용되지 않음.

DbConnectionStringBuilder이 읽기 전용인지 여부를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DbConnectionStringBuilder)
Item[String]
사용되지 않음.

지정된 키에 연결된 값을 가져오거나 설정합니다. C#에서는 이 속성이 인덱서입니다.

Keys
사용되지 않음.

ICollection의 키를 포함하는 OracleConnectionStringBuilder을 가져옵니다.

LoadBalanceTimeout
사용되지 않음.

연결이 제거되기 전에 연결 풀에 유지되는 최소 시간(초)을 가져오거나 설정합니다.

MaxPoolSize
사용되지 않음.

이 특정 연결 문자열에 대해 연결 풀에서 허용된 최대 연결 수를 가져오거나 설정합니다.

MinPoolSize
사용되지 않음.

이 특정 연결 문자열에 대해 연결 풀에서 허용된 최소 연결 수를 가져오거나 설정합니다.

OmitOracleConnectionName
사용되지 않음.

이전 버전의 Oracle(8.1.7.4.1 이하)에서 트랜잭션 롤백을 사용할 수 있게 하는 플래그를 가져오거나 설정합니다.

Password
사용되지 않음.

Oracle 계정의 암호를 가져오거나 설정합니다.

PersistSecurityInfo
사용되지 않음.

연결이 현재 열려 있거나 열린 상태였으면 암호와 같은 중요한 보안 정보가 연결의 일부로 반환되는지 여부를 나타내는 부울 값을 가져오거나 설정합니다.

Pooling
사용되지 않음.

연결이 풀링되는지 아니면 각 연결이 요청될 때마다 명시적으로 열리는지를 나타내는 부울 값을 가져오거나 설정합니다.

Unicode
사용되지 않음.

클라이언트가 이후 Oracle 클라이언트에서 사용할 수 있는 유니코드 기능을 지원하는지 아니면 유니코드를 인식하지 못하는지를 나타내는 부울 값을 가져오거나 설정합니다.

UserID
사용되지 않음.

Oracle에 연결할 때 사용할 사용자 ID를 가져오거나 설정합니다.

Values
사용되지 않음.

ICollection의 값을 포함하는 OracleConnectionStringBuilder을 가져옵니다.

메서드

Add(String, Object)
사용되지 않음.

지정한 키와 값을 가지는 엔트리를 DbConnectionStringBuilder에 추가합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
Clear()
사용되지 않음.

OracleConnectionStringBuilder 인스턴스의 콘텐츠를 지웁니다.

ClearPropertyDescriptors()
사용되지 않음.

연결된 DbConnectionStringBuilder에서 PropertyDescriptor 개체의 컬렉션을 지웁니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ContainsKey(String)
사용되지 않음.

OracleConnectionStringBuilder에 특정 키가 들어 있는지 여부를 확인합니다.

Equals(Object)
사용되지 않음.

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
EquivalentTo(DbConnectionStringBuilder)
사용되지 않음.

DbConnectionStringBuilder 개체의 연결 정보를 제공된 개체의 연결 정보와 비교합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
GetHashCode()
사용되지 않음.

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetProperties(Hashtable)
사용되지 않음.

제공된 Hashtable 을 이 DbConnectionStringBuilder의 모든 속성에 대한 정보로 채웁니다.

(다음에서 상속됨 DbConnectionStringBuilder)
GetType()
사용되지 않음.

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
MemberwiseClone()
사용되지 않음.

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
Remove(String)
사용되지 않음.

지정된 키를 가진 항목을 OracleConnectionStringBuilder 인스턴스에서 제거합니다.

ShouldSerialize(String)
사용되지 않음.

OracleConnectionStringBuilder 인스턴스에 지정된 키가 있는지 여부를 나타냅니다.

ToString()
사용되지 않음.

DbConnectionStringBuilder와 연결된 연결 문자열을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
TryGetValue(String, Object)
사용되지 않음.

OracleConnectionStringBuilder에서 제공된 키에 해당하는 값을 검색합니다.

명시적 인터페이스 구현

ICollection.CopyTo(Array, Int32)
사용되지 않음.

특정 ICollection 인덱스부터 시작하여 Array의 요소를 Array에 복사합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICollection.IsSynchronized
사용되지 않음.

ICollection에 대한 액세스가 동기화되어 스레드로부터 안전하게 보호되는지를 나타내는 값을 가져옵니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICollection.SyncRoot
사용되지 않음.

ICollection에 대한 액세스를 동기화하는 데 사용할 수 있는 개체를 가져옵니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()
사용되지 않음.

해당 구성 요소 인스턴스에 대한 사용자 지정 특성의 컬렉션을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()
사용되지 않음.

해당 구성 요소 인스턴스의 클래스 이름을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()
사용되지 않음.

해당 구성 요소 인스턴스의 이름을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()
사용되지 않음.

해당 구성 요소 인스턴스에 대한 형식 변환기를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()
사용되지 않음.

해당 구성 요소 인스턴스의 기본 이벤트를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()
사용되지 않음.

해당 구성 요소 인스턴스의 기본 속성을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)
사용되지 않음.

해당 구성 요소 인스턴스에 대한 지정된 형식의 편집기를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()
사용되지 않음.

해당 구성 요소 인스턴스의 이벤트를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])
사용되지 않음.

지정된 특성 배열을 필터로 사용하여 해당 구성 요소 인스턴스의 이벤트를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()
사용되지 않음.

해당 구성 요소 인스턴스의 속성을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])
사용되지 않음.

특성 배열을 필터로 사용하여 해당 구성 요소 인스턴스의 속성을 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)
사용되지 않음.

지정된 속성 설명자가 설명하는 속성이 포함된 개체를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IDictionary.Add(Object, Object)
사용되지 않음.

제공된 키와 값을 가진 요소를 IDictionary 개체에 추가합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IDictionary.Contains(Object)
사용되지 않음.

IDictionary 개체에 지정한 키를 가진 요소가 포함되어 있는지 여부를 결정합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IDictionary.GetEnumerator()
사용되지 않음.

IDictionaryEnumerator 개체의 IDictionary 개체를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IDictionary.Item[Object]
사용되지 않음.

지정한 키를 가진 요소를 가져오거나 설정합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IDictionary.Remove(Object)
사용되지 않음.

IDictionary 개체에서 지정한 키를 가지는 요소를 제거합니다.

(다음에서 상속됨 DbConnectionStringBuilder)
IEnumerable.GetEnumerator()
사용되지 않음.

컬렉션을 반복하는 열거자를 반환합니다.

(다음에서 상속됨 DbConnectionStringBuilder)

확장 메서드

Cast<TResult>(IEnumerable)
사용되지 않음.

IEnumerable의 요소를 지정된 형식으로 캐스팅합니다.

OfType<TResult>(IEnumerable)
사용되지 않음.

지정된 형식에 따라 IEnumerable의 요소를 필터링합니다.

AsParallel(IEnumerable)
사용되지 않음.

쿼리를 병렬화할 수 있도록 합니다.

AsQueryable(IEnumerable)
사용되지 않음.

IEnumerableIQueryable로 변환합니다.

적용 대상

추가 정보