SqlConnectionStringBuilder 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
SqlConnection 클래스에서 사용하는 연결 문자열의 콘텐츠를 만들고 관리하는 간단한 방법을 제공합니다.
public ref class SqlConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilderpublic sealed class SqlConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder+SqlConnectionStringBuilderConverter))]
public sealed class SqlConnectionStringBuilder : System.Data.Common.DbConnectionStringBuildertype SqlConnectionStringBuilder = class
inherit DbConnectionStringBuilder[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder+SqlConnectionStringBuilderConverter))>]
type SqlConnectionStringBuilder = class
inherit DbConnectionStringBuilderPublic NotInheritable Class SqlConnectionStringBuilder
Inherits DbConnectionStringBuilder- 상속
- 특성
예제
다음 콘솔 애플리케이션은 SQL Server 데이터베이스에 대한 연결 문자열을 빌드합니다. 이 코드는 SqlConnectionStringBuilder 클래스를 사용하여 연결 문자열을 만듭니다. 그런 다음, 연결 문자열을 구문 분석하고 해당 내용을 조작하는 다양한 방법을 보여 줍니다.
// Create a new SqlConnectionStringBuilder and
// initialize it with a few name/value pairs.
SqlConnectionStringBuilder builder = new(
"Server=(local);Integrated Security=true;" +
"Initial Catalog=AdventureWorks"
);
// The input connection string used the
// Server key, but the new connection string uses
// the well-known Data Source key instead.
Console.WriteLine($"Original connection string: '{builder.ConnectionString}'");
// Now that the connection string has been parsed,
// you can work with individual items.
Console.WriteLine($"Initial catalog: '{builder.InitialCatalog}'");
builder.InitialCatalog = "Northwind";
builder.AsynchronousProcessing = 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["Connect Timeout"] = 1000;
builder["Trusted_Connection"] = true;
Console.WriteLine($"Modified connection string: '{builder.ConnectionString}'");
Imports System.Data.SqlClient
Module Module1
Sub Main()
' Create a new SqlConnectionStringBuilder and
' initialize it with a few name/value pairs:
Dim builder As New SqlConnectionStringBuilder(
"Server=(local);Integrated Security=true;" &
"Initial Catalog=AdventureWorks"
)
' The input connection string used the
' Server key, but the new connection string uses
' the well-known Data Source key instead.
Console.WriteLine("Original connection string: " + builder.ConnectionString)
' Now that the connection string has been parsed,
' you can work with individual items.
Console.WriteLine("Initial catalog: " + builder.InitialCatalog)
builder.InitialCatalog = "Northwind"
builder.AsynchronousProcessing = 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("Connect 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("Trusted_Connection") = True
Console.WriteLine("Modified connection string: " + builder.ConnectionString)
End Sub
End Module
설명
연결 문자열 작성기를 사용하면 개발자가 프로그래밍 방식으로 올바른 연결 문자열을 만들고 클래스의 속성과 메서드를 사용하여 기존 연결 문자열을 구문 분석하고 다시 작성할 수 있습니다. 연결 문자열 작성기에서는 SQL Server에서 허용하는 알려진 키/값 쌍에 해당하는 강력한 형식의 속성을 제공합니다. 앱의 일부로 연결 문자열을 만들어야 하는 경우 SqlConnectionStringBuilder 클래스를 사용하여 연결 문자열을 빌드하고 수정할 수 있습니다. 또한 이 클래스를 사용하면 애플리케이션 구성 파일에 저장된 연결 문자열을 쉽게 관리할 수 있습니다.
SqlConnectionStringBuilder 유효한 키/값 쌍에 대한 검사를 수행합니다. 따라서 이 클래스를 사용하여 잘못된 연결 문자열을 만들 수 없습니다. 잘못된 쌍을 추가하려고 하면 예외가 throw됩니다. 클래스는 고정된 동의어 컬렉션을 유지 관리하며 동의어에서 잘 알려진 해당 키 이름으로 변환할 수 있습니다.
예를 들어 Item 속성을 사용하여 값을 검색하는 경우 필요한 키의 동의어를 포함하는 문자열을 지정할 수 있습니다. 예를 들어 Item[String] 속성 또는 Remove 메서드와 같이 키 이름이 포함된 문자열이 필요한 멤버를 사용하는 경우 연결 문자열 내에서 이 키에 대해 "네트워크 주소", "addr" 또는 기타 허용되는 동의어를 지정할 수 있습니다. 허용되는 동의어의 전체 목록은 ConnectionString 속성을 참조하세요.
Item[String] 속성은 악의적인 항목을 삽입하려는 시도를 처리합니다. 예를 들어 다음 코드는 기본 Item 속성(C#의 인덱서)을 사용하여 중첩된 키/값 쌍을 올바르게 이스케이프합니다.
Dim builder As New System.Data.SqlClient.SqlConnectionStringBuilder
builder("Data Source") = "(local)"
builder("Integrated Security") = True
builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"
Console.WriteLine(builder.ConnectionString)
System.Data.SqlClient.SqlConnectionStringBuilder builder =
new System.Data.SqlClient.SqlConnectionStringBuilder();
builder["Data Source"] = "(local)";
builder["integrated Security"] = true;
builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";
Console.WriteLine(builder.ConnectionString);
결과는 안전한 방식으로 잘못된 값을 처리하는 다음 연결 문자열입니다.
Source=(local);Initial Catalog="AdventureWorks;NewValue=Bad";
Integrated Security=True
생성자
| SqlConnectionStringBuilder() |
SqlConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. |
| SqlConnectionStringBuilder(String) |
SqlConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. 제공된 연결 문자열은 인스턴스의 내부 연결 정보에 대한 데이터를 제공합니다. |
속성
| ApplicationIntent |
SQL Server 가용성 그룹의 데이터베이스에 연결할 때 애플리케이션 워크로드 유형을 선언합니다. ApplicationIntent사용하여 이 속성의 값을 설정할 수 있습니다. Always On 가용성 그룹에 대한 SqlClient 지원에 대한 자세한 내용은 고가용성 재해 복구대한 SqlClient 지원을 참조하세요. |
| ApplicationName |
연결 문자열과 연결된 애플리케이션의 이름을 가져오거나 설정합니다. |
| AsynchronousProcessing |
이 연결 문자열을 사용하여 만든 연결에서 비동기 처리를 허용하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| AttachDBFilename |
기본 데이터 파일의 이름을 포함하는 문자열을 가져오거나 설정합니다. 여기에는 연결 가능한 데이터베이스의 전체 경로 이름이 포함됩니다. |
| Authentication |
연결 문자열의 인증을 가져옵니다. |
| BrowsableConnectionString |
ConnectionString 속성이 Visual Studio 디자이너에 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| ColumnEncryptionSetting |
연결 문자열 작성기에서 열 암호화 설정을 가져오거나 설정합니다. |
| ConnectionReset |
사용되지 않음.
되지 않는. 연결 풀에서 그릴 때 연결이 다시 설정되는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| ConnectionString |
DbConnectionStringBuilder연결된 연결 문자열을 가져오거나 설정합니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| ConnectRetryCount |
유휴 연결 오류가 있음을 확인한 후 시도한 다시 연결 수입니다. 0에서 255 사이의 정수여야 합니다. 기본값은 1입니다. 유휴 연결 실패 시 다시 연결을 사용하지 않도록 설정하려면 0으로 설정합니다. 허용되는 범위를 벗어난 값으로 설정하면 ArgumentException throw됩니다. |
| ConnectRetryInterval |
유휴 연결 오류가 있음을 확인한 후 각 다시 연결 시도 사이의 시간(초)입니다. 1에서 60 사이의 정수여야 합니다. 기본값은 10초입니다. 허용되는 범위를 벗어난 값으로 설정하면 ArgumentException throw됩니다. |
| ConnectTimeout |
시도를 종료하고 오류를 생성하기 전에 서버에 대한 연결을 기다리는 시간(초)을 가져오거나 설정합니다. |
| ContextConnection |
SQL Server에 대한 클라이언트/서버 또는 In-process 연결을 만들어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| Count |
ConnectionString 속성에 포함된 현재 키 수를 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| CurrentLanguage |
SQL Server 언어 레코드 이름을 가져오거나 설정합니다. |
| DataSource |
연결할 SQL Server 인스턴스의 이름 또는 네트워크 주소를 가져오거나 설정합니다. |
| EnclaveAttestationUrl |
Enclave 기반 Always Encrypted와 함께 사용할 enclave 증명 URL을 가져오거나 설정합니다. |
| Encrypt |
서버에 인증서가 설치된 경우 SQL Server가 클라이언트와 서버 간에 전송된 모든 데이터에 SSL 암호화를 사용하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| Enlist |
SQL Server 연결 풀러가 생성 스레드의 현재 트랜잭션 컨텍스트에서 연결을 자동으로 등록하는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| FailoverPartner |
주 서버가 다운된 경우 연결할 파트너 서버의 이름 또는 주소를 가져오거나 설정합니다. |
| InitialCatalog |
연결과 연결된 데이터베이스의 이름을 가져오거나 설정합니다. |
| IntegratedSecurity |
연결에 사용자 ID 및 암호가 지정되어 있는지( |
| IsFixedSize |
SqlConnectionStringBuilder 고정 크기인지 여부를 나타내는 값을 가져옵니다. |
| IsFixedSize |
DbConnectionStringBuilder 고정 크기인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| IsReadOnly |
DbConnectionStringBuilder 읽기 전용인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| Item[String] |
지정된 키와 연결된 값을 가져오거나 설정합니다. C#에서 이 속성은 인덱서입니다. |
| Keys |
SqlConnectionStringBuilder키가 포함된 ICollection 가져옵니다. |
| LoadBalanceTimeout |
연결이 소멸되기 전에 연결 풀에 있는 최소 시간(초)을 가져오거나 설정합니다. |
| MaxPoolSize |
이 특정 연결 문자열에 대해 연결 풀에 허용되는 최대 연결 수를 가져오거나 설정합니다. |
| MinPoolSize |
이 특정 연결 문자열에 대해 연결 풀에 허용되는 최소 연결 수를 가져오거나 설정합니다. |
| MultipleActiveResultSets |
true이면 애플리케이션이 MARS(여러 활성 결과 집합)를 유지할 수 있습니다. false이면 애플리케이션이 한 일괄 처리의 모든 결과 집합을 처리하거나 취소해야 해당 연결에서 다른 일괄 처리를 실행할 수 있습니다. 자세한 내용은 MARS(다중 활성 결과 집합) |
| MultiSubnetFailover |
애플리케이션이 다른 서브넷의 Always On AG(가용성 그룹) 또는 Always On FCI(장애 조치(failover) 클러스터 인스턴스)에 연결하는 경우 MultiSubnetFailover=true를 설정하면 (현재) 활성 서버에 대한 빠른 검색 및 연결을 제공합니다. Always On 기능에 대한 SqlClient 지원에 대한 자세한 내용은 고가용성 재해 복구대한 SqlClient 지원을 참조하세요. |
| NetworkLibrary |
SQL Server에 대한 연결을 설정하는 데 사용되는 네트워크 라이브러리의 이름을 포함하는 문자열을 가져오거나 설정합니다. |
| PacketSize |
SQL Server 인스턴스와 통신하는 데 사용되는 네트워크 패킷의 크기(바이트)를 가져오거나 설정합니다. |
| Password |
SQL Server 계정의 암호를 가져오거나 설정합니다. |
| PersistSecurityInfo |
암호 또는 액세스 토큰과 같은 보안에 중요한 정보가 연결이 열린 상태가 된 후 이 SqlConnectionStringBuilder 사용하여 만든 연결에서 연결 문자열의 일부로 반환되어야 하는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| PoolBlockingPeriod |
연결 풀에 대한 차단 기간 동작입니다. |
| Pooling |
연결이 요청될 때마다 연결을 풀하거나 명시적으로 열지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| Replication |
연결을 사용하여 복제가 지원되는지 여부를 나타내는 부울 값을 가져오거나 설정합니다. |
| TransactionBinding |
연결이 등록된 |
| TransparentNetworkIPResolution |
이 키의 값이 |
| TrustServerCertificate |
트러스트의 유효성을 검사하기 위해 인증서 체인을 건너뛰는 동안 채널이 암호화되는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| TypeSystemVersion |
애플리케이션에서 예상하는 형식 시스템을 나타내는 문자열 값을 가져오거나 설정합니다. |
| UserID |
SQL Server에 연결할 때 사용할 사용자 ID를 가져오거나 설정합니다. |
| UserInstance |
기본 SQL Server Express 인스턴스에서 호출자의 계정으로 실행되는 런타임 시작 인스턴스로 연결을 리디렉션할지 여부를 나타내는 값을 가져오거나 설정합니다. |
| Values |
SqlConnectionStringBuilder값이 포함된 ICollection 가져옵니다. |
| WorkstationID |
SQL Server에 연결하는 워크스테이션의 이름을 가져오거나 설정합니다. |
메서드
명시적 인터페이스 구현
확장 메서드
| Cast<TResult>(IEnumerable) |
IEnumerable 요소를 지정된 형식으로 캐스팅합니다. |
| OfType<TResult>(IEnumerable) |
지정된 형식에 따라 IEnumerable 요소를 필터링합니다. |
| AsParallel(IEnumerable) |
쿼리의 병렬 처리를 사용하도록 설정합니다. |
| AsQueryable(IEnumerable) |
IEnumerable IQueryable변환합니다. |
적용 대상
추가 정보
.NET