OleDbConnectionStringBuilder.OleDbServices プロパティ

.NET Framework クラス ライブラリ リファレンス

OleDbConnectionStringBuilder.OleDbServices プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

接続文字列の中で OLE DB Services キーに対応する値を取得または設定します。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property OleDbServices As
 Integer

Visual Basic (使用法)

Dim instance As OleDbConnectionStringBuilder
Dim value As Integer

value = instance.OleDbServices

instance.OleDbServices = value

C#

public int OleDbServices { get;
 set; }

C++

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

J#

/** @property */
public int get_OleDbServices ()

/** @property */
public void set_OleDbServices (int
 value)

JScript

public function get OleDbServices
 () : int

public function set OleDbServices
 (value : int)

プロパティ値
接続文字列の中で OLE DB Services キーに対応する値を返します。既定値は -13 です。

解説

接続文字列中の OLE DB Services キーは、開発者が OLE DB サービスを有効にしたり無効にしたりするための値の組み合わせを定義します。このプロパティには、値のビットごとの組み合わせが格納されます。この点については、OLE DB のドキュメントに詳しく記載されています。このプロパティに使用できる値の詳細については、「OLE DB Programmer's Reference」の「Overriding Provider Service Defaults」を参照してください。このプロパティの既定値は -13 です。これは、リソース プール、自動トランザクション参加、およびセッション レベル集約を有効にし、クライアント カーソル エンジンは無効にすることを意味します。

使用例

次の例では、OleDbServices プロパティを 2 とおりの方法で操作しています。まず、このプロパティに直接値を設定する方法です。これが、生成される接続文字列にどのような影響を及ぼすかを示します。次に、OleDbConnectionStringBuilder をクリアし、OLE DB Services キーの値を含む完全な接続文字列を設定する方法です。ここでは、接続文字列から値を設定しても、OleDbServices プロパティが変わることを示します。

Visual Basic

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

C#

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();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OleDbConnectionStringBuilder クラス
OleDbConnectionStringBuilder メンバ
System.Data.OleDb 名前空間
その他の技術情報
Building Connection Strings
接続文字列の使用