OleDbConnectionStringBuilder.OleDbServices Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja a kapcsolati karakterlánc belüli OLE DB Services-kulcs átadandó értékét.
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, setPublic Property OleDbServices As IntegerTulajdonság értéke
Az OLE DB Services kulcsnak megfelelő érték a kapcsolati karakterlánc belül. Alapértelmezés szerint az érték -13.
- Attribútumok
Példák
Az alábbi példa kétféleképpen működik a OleDbServices tulajdonsággal. Először egy értéket rendel közvetlenül a tulajdonsághoz, bemutatva, hogy a művelet milyen hatással van az eredményül kapott kapcsolati karakterlánc. Ezután a példa törli a OleDbConnectionStringBuilder, és hozzárendel egy teljes kapcsolati karakterlánc, amely az OLE DB Services-kulcs értékét tartalmazza. Ez a lépés bemutatja, hogy a kapcsolati karakterlánc értékének beállítása a OleDbServices tulajdonságot is módosítja.
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
Megjegyzések
Az OLE DB Services kulcs a kapcsolati karakterlánc olyan értékek kombinációját határozza meg, amelyek lehetővé teszik a fejlesztők számára az OLE DB-szolgáltatások engedélyezését vagy letiltását. A tulajdonság az értékek bitenkénti kombinációját tartalmazza az OLE DB dokumentációjában leírtak szerint. A tulajdonság megfelelő értékeivel kapcsolatos további információkért lásd az OLE DB programozójának referenciáját, különösen a "Felülbírálási szolgáltatói szolgáltatás alapértelmezései" című témakört. A tulajdonság alapértelmezett értéke -13. Ez megfelel az erőforráskészletezésre, az automatikus tranzakcióbesorolásra, a munkamenetszintű összesítésre és az ügyfél-kurzormotorra vonatkozó kérésnek.
