OleDbConnectionStringBuilder.OleDbServices Özellik

Tanım

Ad Alanı:

System.Data.OleDb

Bütünleştirilmiş Kod:

System.Data.OleDb.dll

Paket:

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

Kaynak:

OleDbConnectionStringBuilder.cs

bağlantı dizesi içindeki OLE DB Hizmetleri anahtarı için geçirilecek değeri alır veya ayarlar.

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

Özellik Değeri

Int32

bağlantı dizesi içindeki OLE DB Hizmetleri anahtarına karşılık gelen değer. Varsayılan olarak, değer -13'dür.

Öznitelikler

TypeConverterAttribute

Örnekler

Aşağıdaki örnek özelliğiyle OleDbServices iki şekilde çalışır. İlk olarak, doğrudan özelliğine bir değer atar ve bu eylemin sonuçta elde edilen bağlantı dizesi üzerindeki etkisini gösterir. Ardından, örnek öğesini temizler OleDbConnectionStringBuilder ve OLE DB Hizmetleri anahtarı için bir değer içeren tam bir bağlantı dizesi atar. Bu adım, bağlantı dizesi değerini ayarlamanın özelliği de değiştirdiğini OleDbServices gösterir.

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

Açıklamalar

bağlantı dizesi içindeki OLE DB Hizmetleri anahtarı, geliştiricilerin OLE DB hizmetlerini etkinleştirmesine veya devre dışı bırakmasına izin veren değerlerin bir bileşimini tanımlar. özelliği, OLE DB belgelerinde açıklanan değerlerin bit düzeyinde bir bileşimini içerir. Bu özellik için uygun değerler hakkında daha fazla bilgi için OLE DB Programcı Başvurusu'na (özellikle de "Sağlayıcı Hizmeti Varsayılanlarını Geçersiz Kılma") bakın. Bu özelliğin varsayılan değeri -13'dür. Bu, kaynak havuzu, otomatik işlem listesi, oturum düzeyi toplama isteğine karşılık gelir ve istemci imleç altyapısı yoktur.

Ayrıca bkz.

• Bağlantı Dizesi Oluşturucular
• ADO.NET'da Bağlantı Dizeleri