OleDbConnectionStringBuilder.OleDbServices 속성

정의

네임스페이스:

System.Data.OleDb

어셈블리:

System.Data.OleDb.dll

패키지:

System.Data.OleDb v11.0.0-preview.2.26159.112

Source:

OleDbConnectionStringBuilder.cs

연결 문자열 내에서 OLE DB 서비스 키에 전달할 값을 가져오거나 설정합니다.

public:
 property int OleDbServices { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbServicesConverter))]
public int OleDbServices { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbServicesConverter))>]
member this.OleDbServices : int with get, set

Public Property OleDbServices As Integer

속성 값

Int32

연결 문자열 내의 OLE DB 서비스 키에 해당하는 값입니다. 기본적으로 값은 -13입니다.

특성

TypeConverterAttribute

예제

다음 예제에서는 두 가지 방법으로 속성으로 OleDbServices 작동합니다. 먼저 속성에 직접 값을 할당하여 이 작업이 결과 연결 문자열에 미치는 영향을 보여 줍니다. 그런 다음, OLE DB 서비스 키에 OleDbConnectionStringBuilder 대한 값을 포함하는 전체 연결 문자열을 지우고 할당합니다. 이 단계에서는 연결 문자열에서 값을 설정하면 속성도 수정되는 것을 OleDbServices 보여 줍니다.

using System.Data.OleDb;

class Program
{
    // These constants correspond to values in the
    // OLE DB SDK. You can use these values to
    // turn features on and off.
    private const int DBPROPVAL_OS_AGR_AFTERSESSION = 8;
    private const int DBPROPVAL_OS_AGR_RESOURCEPOOLING = 1;
    private const int DBPROPVAL_OS_AGR_TXNENLISTMENT = 2;
    private const int DBPROPVAL_OS_AGR_CLIENTCURSOR = 4;
    private const int DBPROPVAL_OS_ENABLEALL = -1;
    private const int DBPROPVAL_OS_DISABLEALL = 0;

    static void Main()
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder();
        // Turn on all services except resource pooling.
        builder.OleDbServices =
            DBPROPVAL_OS_ENABLEALL &
            ~DBPROPVAL_OS_AGR_RESOURCEPOOLING;

        builder.Provider = "sqloledb";
        builder.DataSource = "(local)";
        builder["Initial Catalog"] = "AdventureWorks";
        builder["Integrated Security"] = "SSPI";

        // Store the connection string.
        string savedConnectionString = builder.ConnectionString;
        Console.WriteLine(savedConnectionString);

        // Reset the object. This resets all the properties to their
        // default values.
        builder.Clear();

        // Investigate the OleDbServices property before
        // and after assigning a connection string value.
        Console.WriteLine("Default : " + builder.OleDbServices);
        builder.ConnectionString = savedConnectionString;
        Console.WriteLine("Modified: " + builder.OleDbServices);

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

Imports System.Data.OleDb    

Module Module1
  ' These constants correspond to values in the 
  ' OLE DB SDK. You can use these values to 
  ' turn features on and off.
  Private Const DBPROPVAL_OS_AGR_AFTERSESSION As Integer = 8
  Private Const DBPROPVAL_OS_AGR_RESOURCEPOOLING As Integer = 1
  Private Const DBPROPVAL_OS_AGR_TXNENLISTMENT As Integer = 2
  Private Const DBPROPVAL_OS_AGR_CLIENTCURSOR As Integer = 4
  Private Const DBPROPVAL_OS_ENABLEALL As Integer = -1
  Private Const DBPROPVAL_OS_DISABLEALL As Integer = 0

  Sub Main()
    Dim builder As New OleDbConnectionStringBuilder()
    ' Turn on all services except resource pooling.
    builder.OleDbServices = DBPROPVAL_OS_ENABLEALL _
     And Not DBPROPVAL_OS_AGR_RESOURCEPOOLING

    builder.Provider = "sqloledb"
    builder.DataSource = "(local)"
    builder("Initial Catalog") = "AdventureWorks"
    builder("Integrated Security") = "SSPI"

    ' Store the connection string.
    Dim savedConnectionString As String = builder.ConnectionString
    Console.WriteLine(savedConnectionString)

    ' Reset the object. This resets all the properties to their
    ' default values.
    builder.Clear()

    ' Investigate the OleDbServices property before
    ' and after assigning a connection string value.
    Console.WriteLine("Default : " & builder.OleDbServices)
    builder.ConnectionString = savedConnectionString
    Console.WriteLine("Modified: " & builder.OleDbServices)

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

설명

연결 문자열 내의 OLE DB 서비스 키는 개발자가 OLE DB 서비스를 사용하거나 사용하지 않도록 설정할 수 있는 값의 조합을 정의합니다. 이 속성에는 OLE DB 설명서에 설명된 값의 비트 조합이 포함되어 있습니다. 이 속성에 대한 적절한 값에 대한 자세한 내용은 OLE DB 프로그래머 참조, 특히 "공급자 서비스 기본값 재정의"를 참조하세요. 이 속성의 기본값은 -13입니다. 리소스 풀링, 자동 트랜잭션 인리스트먼트, 세션 수준 집계 및 클라이언트 커서 엔진이 없는 요청에 해당합니다.

추가 정보

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