DbConnectionStringBuilder.ConnectionString 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
DbConnectionStringBuilder와 연결된 연결 문자열을 가져오거나 설정합니다.
public:
property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };public string ConnectionString { get; set; }member this.ConnectionString : string with get, setPublic Property ConnectionString As String속성 값
DbConnectionStringBuilder 내에 포함된 키/값 쌍에서 만든 현재 연결 문자열입니다. 기본값은 빈 문자열입니다.
예외
잘못된 연결 문자열 인수가 제공되었습니다.
예제
다음 예제에서는 가능한 동작을 ConnectionString 보여 줍니다는 속성입니다. 예:
한 번에 하나씩 키/값 쌍을 빈 DbConnectionStringBuilder에 추가하여 연결 문자열 만듭니다.
전체 연결 문자열 instance ConnectionString 속성에 DbConnectionStringBuilder 할당하고 문자열 내에서 단일 키/값 쌍을 수정합니다.
속성에 임의의 키/값 쌍 ConnectionString 집합(즉, 연결 문자열 같이 원격으로 아무것도 아닌 문자열)을 할당하고 값 중 하나를 수정합니다.
throw된 예외를 보여 주는 잘못된 연결 문자열 ConnectionString 속성에 할당합니다.
참고
이 예제에는 DbConnectionStringBuilder가 연결 문자열로 작업하는 방법을 보여 주기 위한 암호가 포함되어 있습니다. 애플리케이션에서는 Windows 인증을 사용하는 것이 좋습니다. 암호를 사용해야 하는 경우에는 애플리케이션에 하드 코드된 암호를 포함하지 마십시오.
static void Main()
{
// Create a new DbConnctionStringBuilder, and add items
// to the internal collection of key/value pairs.
DbConnectionStringBuilder builder = new
DbConnectionStringBuilder();
builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
builder.Add("Jet OLEDB:Database Password", "********");
builder.Add("Jet OLEDB:System Database",
@"c:\MyData\Workgroup.mdb");
// Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);
// Display the contents of the connection string, which
// will now contain all the key/value pairs delimited with
// semicolons.
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Clear the DbConnectionStringBuilder, and assign a complete
// connection string to it, to demonstrate how
// the class parses connection strings.
builder.Clear();
builder.ConnectionString =
"Data Source=(local);Initial Catalog=AdventureWorks;"
+ "Integrated Security=SSPI";
// The DbConnectionStringBuilder class has parsed the contents,
// so you can work with any individual key/value pair.
builder["Data Source"] = ".";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
// Because the DbConnectionStringBuilder class doesn't
// validate its key/value pairs, you can use this class
// to store any semicolon-delimited list. The following
// snippet places an arbitrary string into the ConnectionString
// property, changes one of the values, and then displays the
// resulting string.
builder.Clear();
builder.ConnectionString =
"Value1=10;Value2=20;Value3=30;Value4=40";
builder["Value2"] = 25;
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
builder.Clear();
try
{
// Assigning an invalid connection string
// throws an ArgumentException.
builder.ConnectionString = "xxx";
}
catch (ArgumentException)
{
Console.WriteLine("Invalid connection string.");
}
Console.WriteLine();
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
Sub Main()
' Create a new DbConnctionStringBuilder, and add items
' to the internal collection of key/value pairs.
Dim builder As New DbConnectionStringBuilder()
builder.Add("Data Source", "c:\MyData\MyDb.mdb")
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
builder.Add("Jet OLEDB:Database Password", "*******")
builder.Add("Jet OLEDB:System Database", _
"c:\MyData\Workgroup.mdb")
' Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1)
' Display the contents of the connection string, which
' will now contain all the key/value pairs delimited with
' semicolons.
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Clear the DbConnectionStringBuilder, and assign a complete
' connection string to it, to demonstrate how
' the class parses connection strings.
builder.Clear()
builder.ConnectionString = _
"Data Source=(local);Initial Catalog=AdventureWorks;" & _
"Integrated Security=SSPI"
' The DbConnectionStringBuilder class has parsed the contents,
' so you can work with any individual key/value pair.
builder("Data Source") = "."
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
' Because the DbConnectionStringBuilder class doesn't
' validate its key/value pairs, you can use this class
' to store any semicolon-delimited list. The following
' snippet places an arbitrary string into the ConnectionString
' property, changes one of the values, and then displays the
' resulting string.
builder.Clear()
builder.ConnectionString = _
"Value1=10;Value2=20;Value3=30;Value4=40"
builder("Value2") = 25
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
builder.Clear()
Try
' Assigning an invalid connection string
' throws an ArgumentException.
builder.ConnectionString = "xxx"
Catch ex As ArgumentException
Console.WriteLine("Invalid connection string.")
End Try
Console.WriteLine()
Console.WriteLine("Press Enter to finish.")
Console.ReadLine()
End Sub
설명
이 속성은 에 의해 DbConnectionStringBuilder유지 관리되는 컬렉션 내에 저장된 키/값 쌍의 세미콜론으로 구분된 목록을 반환합니다. 각 쌍에는 등호로 구분된 키와 값이 포함됩니다. 다음 예제에서는 일반적인 연결 문자열 보여 줍니다.
"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"
데이터 공급자는 각 연결 문자열 속성에 대해 특정 키와 값을 기대할 수 있습니다. , 이러한 값은 개별적으로 문서화됩니다. 클래스는 DbConnectionStringBuilder 해당 연결 문자열 연결된 키/값 쌍의 유효성을 검사하지 않지만 상속된 클래스는 유효성을 검사할 수 있습니다.
의 속성 DbConnectionStringBuilder 은 ConnectionString 일반적으로 동일한 기호로 구분된 키/값 쌍의 세미콜론으로 구분된 목록을 만들고 구문 분석하는 메커니즘으로 작동합니다. 연결 문자열과 관련된 유효성 검사 또는 기타 지원을 제공하지 않습니다. 컬렉션에 DbConnectionStringBuilder 항목을 추가하면 속성에 ConnectionString 변경 내용이 반영됩니다. 값을 할당 하는 ConnectionString 경우는 속성을 DbConnectionStringBuilder 세미콜론 및 등호 구분 기호를 사용 하 여 값을 구문 분석 하려고 합니다.
적용 대상
추가 정보
.NET