EntityConnectionStringBuilder 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
EntityClient에서 사용하는 연결 문자열의 내용을 손쉽게 만들고 관리할 수 있는 방법을 제공합니다.
public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilderpublic sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuildertype EntityConnectionStringBuilder = class
inherit DbConnectionStringBuilderPublic NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder- 상속
예제
다음 예제에서는 EntityConnectionStringBuilder와 SqlConnectionStringBuilder를 함께 사용하는 방법을 보여 줍니다.
// Specify the provider name, server and database.
string providerName = "System.Data.SqlClient";
string serverName = ".";
string databaseName = "AdventureWorks";
// Initialize the connection string builder for the
// underlying provider.
SqlConnectionStringBuilder sqlBuilder =
new SqlConnectionStringBuilder();
// Set the properties for the data source.
sqlBuilder.DataSource = serverName;
sqlBuilder.InitialCatalog = databaseName;
sqlBuilder.IntegratedSecurity = true;
// Build the SqlConnection connection string.
string providerString = sqlBuilder.ToString();
// Initialize the EntityConnectionStringBuilder.
EntityConnectionStringBuilder entityBuilder =
new EntityConnectionStringBuilder();
//Set the provider name.
entityBuilder.Provider = providerName;
// Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString;
// Set the Metadata location.
entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl|
res://*/AdventureWorksModel.ssdl|
res://*/AdventureWorksModel.msl";
Console.WriteLine(entityBuilder.ToString());
using (EntityConnection conn =
new EntityConnection(entityBuilder.ToString()))
{
conn.Open();
Console.WriteLine("Just testing the connection.");
conn.Close();
}
' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"
' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder
' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True
' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString
' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder
'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
"res://*/AdventureWorksModel.ssdl|" & _
"res://*/AdventureWorksModel.msl"
Console.WriteLine(entityBuilder.ToString)
Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
conn.Open()
Console.WriteLine("Just testing the connection.")
conn.Close()
End Using
설명
개발자는 연결 문자열 작성기를 사용하여 프로그래밍 방식으로 올바른 구문의 연결 문자열을 만들고 이 클래스의 속성과 메서드를 사용하여 기존 연결 문자열의 구문을 분석한 다음 다시 빌드할 수 있습니다. 연결 문자열 작성기는 알려진 키워드/값 쌍에 해당하는 강력한 형식의 속성을 제공합니다. 애플리케이션에서 연결 문자열을 만들어야 할 경우 개발자는 EntityConnectionStringBuilder 클래스를 사용하여 연결 문자열을 빌드하고 수정할 수 있습니다.
EntityConnectionStringBuilder는 각각이 EntityConnectionStringBuilder 속성 값으로 노출되는 키워드/값 쌍에 대해 유효성 검사를 수행합니다.
참고
기본 데이터 원본에 대한 연결 문자열은 ProviderConnectionString 속성을 통해 제공되며 이 공급자 연결 문자열에 대해서는 키워드/값 쌍에 대한 유효성 검사가 수행되지 않습니다.
생성자
| EntityConnectionStringBuilder() |
EntityConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. |
| EntityConnectionStringBuilder(String) |
제공된 연결 문자열을 사용하여 EntityConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. |
속성
| BrowsableConnectionString |
ConnectionString 속성이 Visual Studio 디자이너에서 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| ConnectionString |
DbConnectionStringBuilder와 연결된 연결 문자열을 가져오거나 설정합니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| Count |
ConnectionString 속성 내에 포함된 키의 현재 수를 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| IsFixedSize |
EntityConnectionStringBuilder의 크기가 고정되어 있는지 여부를 나타내는 값을 가져옵니다. |
| IsReadOnly |
DbConnectionStringBuilder이 읽기 전용인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
| Item[String] |
지정된 키에 연결된 값을 가져오거나 설정합니다. C#에서는 이 속성이 인덱서입니다. |
| Keys |
ICollection의 키를 포함하는 EntityConnectionStringBuilder을 가져옵니다. |
| Metadata |
연결 문자열의 메타데이터 위치를 가져오거나 설정합니다. |
| Name |
구성 파일에 정의되어 있는 섹션의 이름을 가져오거나 설정합니다. |
| Provider |
연결 문자열 기본 .NET Framework 데이터 공급자의 이름을 가져오거나 설정합니다. |
| ProviderConnectionString |
공급자별 내부 연결 문자열을 가져오거나 설정합니다. |
| Values |
ICollection의 값을 포함하는 DbConnectionStringBuilder을 가져옵니다. (다음에서 상속됨 DbConnectionStringBuilder) |
메서드
명시적 인터페이스 구현
확장 메서드
| Cast<TResult>(IEnumerable) |
IEnumerable의 요소를 지정된 형식으로 캐스팅합니다. |
| OfType<TResult>(IEnumerable) |
지정된 형식에 따라 IEnumerable의 요소를 필터링합니다. |
| AsParallel(IEnumerable) |
쿼리를 병렬화할 수 있도록 합니다. |
| AsQueryable(IEnumerable) |
IEnumerable을 IQueryable로 변환합니다. |
적용 대상
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기