OleDbConnectionStringBuilder.OleDbServices Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang akan diteruskan untuk kunci Layanan OLE DB dalam string koneksi.
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
Nilai Properti
Nilai yang sesuai dengan kunci Layanan OLE DB dalam string koneksi. Secara default, nilainya adalah -13.
- Atribut
Contoh
Contoh berikut berfungsi dengan properti dengan OleDbServices dua cara. Pertama, ini menetapkan nilai langsung ke properti , menunjukkan efek yang dimiliki tindakan ini pada string koneksi yang dihasilkan. Kemudian, contoh menghapus OleDbConnectionStringBuilder dan menetapkan string koneksi lengkap yang berisi nilai untuk kunci Layanan OLE DB. Langkah ini menunjukkan bahwa mengatur nilai dari string koneksi memodifikasi OleDbServices properti juga.
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
Keterangan
Kunci Layanan OLE DB dalam string koneksi menentukan kombinasi nilai yang memungkinkan pengembang mengaktifkan atau menonaktifkan layanan OLE DB. Properti berisi kombinasi nilai bitwise, yang dijelaskan dalam dokumentasi OLE DB. Untuk informasi selengkapnya tentang nilai yang sesuai untuk properti ini, lihat Referensi Programmer OLE DB, khususnya, "Mengganti Default Layanan Penyedia." Nilai default untuk properti ini adalah -13. Ini sesuai dengan permintaan untuk pengumpulan sumber daya, pendaftaran transaksi otomatis, agregasi tingkat sesi, dan tanpa mesin kursor klien.