OleDbConnectionStringBuilder.Item[String] 속성

정의

네임스페이스:

System.Data.OleDb

어셈블리:

System.Data.OleDb.dll

패키지:

System.Data.OleDb v9.0.0-preview.3.24172.9

Source:

OleDbConnectionStringBuilder.cs

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

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

매개 변수

keyword

String

가져오거나 설정할 항목의 키입니다.

속성 값

Object

지정한 키와 연결된 값입니다.

예외

ArgumentException

연결 문자열의 형식이 잘못된 경우(예: 키/값 쌍에서 필수 "="가 누락된 경우)

ArgumentNullException

keyword이 null 참조(Visual Basic의 경우 Nothing)인 경우

예제

다음 예제에서는 Item[] 속성 (C# 인덱서) 검색 하 고 키/값 쌍의 컬렉션에 있는 값을 설정 합니다. 이 경우 공급자를 설정 하는 선택한 공급자에 연결 된 모든 키/값 쌍에 대 한 기본값 제공 참고 합니다.

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        OleDbConnectionStringBuilder builder = new OleDbConnectionStringBuilder();
        builder.Provider = "Microsoft.Jet.Oledb.4.0";
        builder.DataSource = @"C:\Sample.mdb";
        // Set properties using the Item property (the indexer, in C#).
        builder["Jet OLEDB:Database Password"] = "DataPassword";
        builder["Jet OLEDB:Encrypt Database"] = true;
        builder["Jet OLEDB:System database"] = @"C:\Workgroup.mdw";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Use the Item property to retrieve values as well.
        Console.WriteLine(builder["Jet OLEDB:System database"]);
        Console.WriteLine(builder["Jet OLEDB:Encrypt Database"]);

        // You can set or retrieve any of the "default" values for the
        // provider, even if you didn't set their values.
        Console.WriteLine(builder["Jet OLEDB:Database Locking Mode"]);
        Console.WriteLine(builder["Jet OLEDB:Global Partial Bulk Ops"]);

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

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Dim builder As New OleDbConnectionStringBuilder
    builder.Provider = "Microsoft.Jet.Oledb.4.0"
    builder.DataSource = "C:\Sample.mdb"
    ' Set properties using the Item property.
    builder.Item("Jet OLEDB:Database Password") = "DataPassword"
    builder.Item("Jet OLEDB:Encrypt Database") = True

    ' Because Item is the default property, you can leave out
    ' the explicit reference.
    builder("Jet OLEDB:System database") = "C:\Workgroup.mdw"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Use the Item property to retrieve values, as well.
    Console.WriteLine(builder.Item("Jet OLEDB:System database"))
    Console.WriteLine(builder("Jet OLEDB:Encrypt Database"))

    ' You can set or retrieve any of the "default" values for the 
    ' provider, as well, even if you did not set their values. Again, 
    ' explicitly specifying the Item property name is optional.
    Console.WriteLine(builder.Item("Jet OLEDB:Database Locking Mode"))
    Console.WriteLine(builder("Jet OLEDB:Global Partial Bulk Ops"))

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

설명

설정 이기 때문에 Provider 속성 (에 따라 특정 공급자의 동작은) 키/값 쌍의 컬렉션에 해당 항목을 추가할 수 있습니다, 명시적으로 설정 하지 않은 키 값을 검색할 수 있습니다. 예를 들어, 설정한 즉시는 Provider 속성 "sqloledb를"를 검색할 수 있습니다 "Workstation ID" 값을 설정 하지 않은 것 직접 하는 경우에 합니다. 데모를 보려면이 항목의 예제를 참조 하세요.

추가 정보

• 연결 문자열 작성기
• ADO.NET의 연결 문자열