OracleConnectionStringBuilder 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
주의
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 DbConnectionStringBuilderPublic NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder- 상속
- 특성
예제
다음 콘솔 애플리케이션에는 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"가 연결에 지정되어 있는지( |
| 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을 가져옵니다. |
메서드
명시적 인터페이스 구현
확장 메서드
| Cast<TResult>(IEnumerable) |
사용되지 않음.
IEnumerable의 요소를 지정된 형식으로 캐스팅합니다. |
| OfType<TResult>(IEnumerable) |
사용되지 않음.
지정된 형식에 따라 IEnumerable의 요소를 필터링합니다. |
| AsParallel(IEnumerable) |
사용되지 않음.
쿼리를 병렬화할 수 있도록 합니다. |
| AsQueryable(IEnumerable) |
사용되지 않음.
IEnumerable을 IQueryable로 변환합니다. |
적용 대상
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기