OleDbConnectionStringBuilder.OleDbServices Eigenschaft

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v8.0.0

Quelle:

OleDbConnectionStringBuilder.cs

Ruft den Wert ab, der für den OLE DB Services-Schlüssel innerhalb der Verbindungszeichenfolge übergeben werden soll, oder legt diesen fest.

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

Eigenschaftswert

Int32

Der Wert, der dem OLE DB Services-Schlüssel in der Verbindungszeichenfolge entspricht. Der Standardwert ist -13.

Attribute

TypeConverterAttribute

Beispiele

Das folgende Beispiel funktioniert auf zwei Arten mit der OleDbServices -Eigenschaft. Zunächst wird der -Eigenschaft direkt ein Wert zugewiesen, wodurch die Auswirkung dieser Aktion auf die resultierende Verbindungszeichenfolge veranschaulicht wird. Anschließend löscht OleDbConnectionStringBuilder das Beispiel und weist eine vollständige Verbindungszeichenfolge zu, die einen Wert für den OLE DB-Dienstschlüssel enthält. In diesem Schritt wird veranschaulicht, dass das Festlegen des Werts aus der Verbindungszeichenfolge auch die OleDbServices -Eigenschaft ändert.

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

Hinweise

Der OLE DB-Dienstschlüssel in der Verbindungszeichenfolge definiert eine Kombination von Werten, mit denen Entwickler OLE DB-Dienste aktivieren oder deaktivieren können. Die -Eigenschaft enthält eine bitweise Kombination von Werten, die in der OLE DB-Dokumentation beschrieben wird. Weitere Informationen zu geeigneten Werten für diese Eigenschaft finden Sie in der OLE DB-Programmiererreferenz, insbesondere "Außerkraftsetzung von Anbieterdienststandardwerten". Der Standardwert für diese Eigenschaft ist -13. Dies entspricht einer Anforderung für Ressourcenpooling, automatische Transaktionseintragung, Aggregation auf Sitzungsebene und keine Clientcursor-Engine.

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET