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 innerhalb des Verbindungszeichenfolge entspricht. Der Standardwert ist -13.

Attribute

TypeConverterAttribute

Beispiele

Das folgende Beispiel funktioniert mit der OleDbServices -Eigenschaft auf zwei Arten. Zunächst wird der -Eigenschaft direkt ein Wert zugewiesen, der die Auswirkung dieser Aktion auf die resultierende Verbindungszeichenfolge veranschaulicht. Anschließend löscht das Beispiel und OleDbConnectionStringBuilder weist eine vollständige Verbindungszeichenfolge zu, die einen Wert für den OLE DB Services-Schlüssel enthält. In diesem Schritt wird veranschaulicht, dass das Festlegen des Werts aus dem 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 Services-Schlüssel innerhalb des 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 "Überschreiben von Anbieterdienststandarden". Der Standardwert für diese Eigenschaft ist -13. Dies entspricht einer Anforderung für Ressourcenpools, automatische Transaktionseintragung, Aggregation auf Sitzungsebene und keine Clientcursor-Engine.

Weitere Informationen

• Verbindungszeichenfolgen-Generatoren
• Verbindungszeichenfolgen in ADO.NET