OracleConnectionStringBuilder Kelas

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Perhatian

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Menyediakan cara sederhana untuk membuat dan mengelola konten string koneksi yang digunakan oleh kelas OracleConnection.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Warisan

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

Atribut

TypeConverterAttribute ObsoleteAttribute

Keterangan

Jenis ini tidak digunakan lagi dan akan dihapus dalam versi .NET Framework yang akan datang. Untuk informasi selengkapnya, lihat Oracle dan ADO.NET.

Penyusun string koneksi memungkinkan pengembang untuk secara terprogram membuat string koneksi yang benar secara sintis, dan untuk mengurai dan membangun kembali string koneksi yang ada, menggunakan properti dan metode kelas. Penyusun string koneksi menyediakan properti yang sangat ditik yang sesuai dengan pasangan kunci/nilai yang diketahui yang diizinkan oleh Oracle. Kelas OracleConnectionStringBuilder mengimplementasikan antarmuka ICustomTypeDescriptor. Ini berarti bahwa kelas berfungsi dengan desainer Visual Studio .NET pada waktu desain. Ketika pengembang menggunakan perancang untuk membangun Himpunan Data yang diketik dengan kuat dan koneksi yang sangat diketik dalam Visual Studio .NET, kelas pembangun string koneksi yang sangat diketik akan menampilkan properti yang terkait dengan jenisnya dan juga akan memiliki konverter yang dapat memetakan nilai umum untuk kunci yang diketahui.

Pengembang perlu membuat string koneksi sebagai bagian dari aplikasi dapat menggunakan kelas OracleConnectionStringBuilder untuk membangun dan memodifikasi string koneksi. Kelas OracleConnectionStringBuilder juga memudahkan untuk mengelola string koneksi yang disimpan dalam file konfigurasi aplikasi.

OracleConnectionStringBuilder melakukan pemeriksaan untuk pasangan kunci/nilai yang valid. Oleh karena itu, kelas ini tidak dapat digunakan untuk membuat string koneksi yang tidak valid. Mencoba menambahkan pasangan yang tidak valid akan melemparkan pengecualian. Kelas OracleConnectionStringBuilder mempertahankan kumpulan sinonim tetap, dan jika diperlukan, dapat melakukan terjemahan yang diperlukan untuk mengonversi dari sinonim ke nama kunci terkenal yang sesuai. Misalnya, saat Anda menggunakan properti Item[] untuk mengambil nilai, Anda dapat menentukan string yang berisi sinonim apa pun untuk kunci yang Anda butuhkan. Lihat properti Item[] untuk daftar lengkap sinonim yang dapat diterima.

OracleConnectionStringBuilder menangani upaya untuk menyisipkan entri berbahaya. Misalnya, kode berikut, menggunakan properti Item[] default (pengindeks, di C#), dengan benar melepaskan pasangan kunci/nilai berlapis.

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
builder("Integrated Security") = True
builder("User ID") = "Mary;NewValue=Bad"
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)

System.Data.OracleClient.OracleConnectionStringBuilder builder =
   new System.Data.OracleClient.OracleConnectionStringBuilder();
builder["Data Source"] = "OracleDemo";
builder["integrated Security"] = true;
builder["User ID"] = "Mary;NewValue=Bad";
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

Hasilnya adalah string koneksi berikut yang menangani nilai yang tidak valid dengan cara yang aman dengan menyertakan nilai ID Pengguna dalam tanda kutip:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"

Peringatan

Microsoft tidak menyarankan untuk memberikan nama pengguna dan kata sandi Anda secara langsung, karena ini adalah pola yang tidak aman. Jika memungkinkan, gunakan alur autentikasi yang lebih aman, seperti identitas terkelola untuk sumber daya Azure, atau autentikasi Windows untuk SQL Server.

Konstruktor

OracleConnectionStringBuilder()	Kedaluwarsa. Menginisialisasi instans baru kelas OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Kedaluwarsa. Menginisialisasi instans baru kelas OracleConnectionStringBuilder. String koneksi yang disediakan menyediakan data untuk informasi koneksi internal instans.

Properti

BrowsableConnectionString	Kedaluwarsa. Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti ConnectionString terlihat di desainer Visual Studio. (Diperoleh dari DbConnectionStringBuilder)
ConnectionString	Kedaluwarsa. Mendapatkan atau mengatur string koneksi yang terkait dengan DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder)
Count	Kedaluwarsa. Mendapatkan jumlah kunci saat ini yang terkandung dalam properti ConnectionString. (Diperoleh dari DbConnectionStringBuilder)
DataSource	Kedaluwarsa. Mendapatkan atau mengatur nama sumber data Oracle untuk disambungkan.
Enlist	Kedaluwarsa. Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengumpul secara otomatis mendaftarkan koneksi dalam konteks transaksi saat ini utas pembuatan.
IntegratedSecurity	Kedaluwarsa. Mendapatkan atau menetapkan nilai yang menunjukkan apakah "ID Pengguna" dan "Kata Sandi" ditentukan dalam koneksi (ketika false) atau apakah kredensial akun Windows saat ini digunakan untuk autentikasi (saat true).
IsFixedSize	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah OracleConnectionStringBuilder memiliki ukuran tetap.
IsReadOnly	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah DbConnectionStringBuilder bersifat baca-saja. (Diperoleh dari DbConnectionStringBuilder)
Item[String]	Kedaluwarsa. Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan. Di C#, properti ini adalah pengindeks.
Keys	Kedaluwarsa. Mendapatkan ICollection yang berisi kunci di OracleConnectionStringBuilder.
LoadBalanceTimeout	Kedaluwarsa. Mendapatkan atau mengatur waktu minimum, dalam detik, agar koneksi hidup di kumpulan koneksi sebelum dihapus.
MaxPoolSize	Kedaluwarsa. Mendapatkan atau mengatur jumlah maksimum koneksi yang diizinkan dalam kumpulan koneksi untuk string koneksi khusus ini.
MinPoolSize	Kedaluwarsa. Mendapatkan atau mengatur jumlah minimum koneksi yang diizinkan dalam kumpulan koneksi untuk string koneksi khusus ini.
OmitOracleConnectionName	Kedaluwarsa. Mendapatkan atau mengatur bendera yang memungkinkan pembatalan transaksi pada versi Oracle yang lebih lama (sebelum 8.1.7.4.1).
Password	Kedaluwarsa. Mendapatkan atau mengatur kata sandi untuk akun Oracle.
PersistSecurityInfo	Kedaluwarsa. Mendapatkan atau mengatur nilai Boolean yang menunjukkan apakah informasi sensitif keamanan, seperti kata sandi, tidak dikembalikan sebagai bagian dari koneksi jika koneksi terbuka atau pernah dalam status terbuka.
Pooling	Kedaluwarsa. Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah koneksi akan dikumpulkan, atau apakah setiap koneksi akan dibuka secara eksplisit setiap kali koneksi diminta.
Unicode	Kedaluwarsa. Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah klien mendukung fungsionalitas Unicode yang tersedia di klien Oracle yang lebih baru, atau jika tidak diketahui Unicode.
UserID	Kedaluwarsa. Mendapatkan atau mengatur ID pengguna yang akan digunakan saat menyambungkan ke Oracle.
Values	Kedaluwarsa. Mendapatkan ICollection yang berisi nilai dalam OracleConnectionStringBuilder.

Metode

Add(String, Object)	Kedaluwarsa. Menambahkan entri dengan kunci dan nilai yang ditentukan ke dalam DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder)
Clear()	Kedaluwarsa. Menghapus konten instans OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Kedaluwarsa. Menghapus kumpulan objek PropertyDescriptor pada DbConnectionStringBuilderterkait . (Diperoleh dari DbConnectionStringBuilder)
ContainsKey(String)	Kedaluwarsa. Menentukan apakah OracleConnectionStringBuilder berisi kunci tertentu.
Equals(Object)	Kedaluwarsa. Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
EquivalentTo(DbConnectionStringBuilder)	Kedaluwarsa. Membandingkan informasi koneksi dalam objek DbConnectionStringBuilder ini dengan informasi koneksi di objek yang disediakan. (Diperoleh dari DbConnectionStringBuilder)
GetHashCode()	Kedaluwarsa. Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperties(Hashtable)	Kedaluwarsa. Mengisi Hashtable yang disediakan dengan informasi tentang semua properti DbConnectionStringBuilderini . (Diperoleh dari DbConnectionStringBuilder)
GetType()	Kedaluwarsa. Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Kedaluwarsa. Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
Remove(String)	Kedaluwarsa. Menghapus entri dengan kunci yang ditentukan dari instans OracleConnectionStringBuilder.
ShouldSerialize(String)	Kedaluwarsa. Menunjukkan apakah kunci yang ditentukan ada dalam instans OracleConnectionStringBuilder ini.
ToString()	Kedaluwarsa. Mengembalikan string koneksi yang terkait dengan DbConnectionStringBuilderini. (Diperoleh dari DbConnectionStringBuilder)
TryGetValue(String, Object)	Kedaluwarsa. Mengambil nilai yang sesuai dengan kunci yang disediakan dari OracleConnectionStringBuilderini.

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Kedaluwarsa. Menyalin elemen ICollection ke Array, dimulai pada indeks Array tertentu. (Diperoleh dari DbConnectionStringBuilder)
ICollection.IsSynchronized	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah akses ke ICollection disinkronkan (utas aman). (Diperoleh dari DbConnectionStringBuilder)
ICollection.SyncRoot	Kedaluwarsa. Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke ICollection. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Kedaluwarsa. Mengembalikan kumpulan atribut kustom untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Kedaluwarsa. Mengembalikan nama kelas instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Kedaluwarsa. Mengembalikan nama instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Kedaluwarsa. Mengembalikan pengonversi jenis untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Kedaluwarsa. Mengembalikan peristiwa default untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Kedaluwarsa. Mengembalikan properti default untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Kedaluwarsa. Mengembalikan editor dari jenis yang ditentukan untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Kedaluwarsa. Mengembalikan peristiwa untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Kedaluwarsa. Mengembalikan peristiwa untuk instans komponen ini menggunakan array atribut yang ditentukan sebagai filter. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Kedaluwarsa. Mengembalikan properti untuk instans komponen ini. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Kedaluwarsa. Mengembalikan properti untuk instans komponen ini menggunakan array atribut sebagai filter. (Diperoleh dari DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Kedaluwarsa. Mengembalikan objek yang berisi properti yang dijelaskan oleh deskriptor properti yang ditentukan. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Kedaluwarsa. Menambahkan elemen dengan kunci dan nilai yang disediakan ke objek IDictionary. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.Contains(Object)	Kedaluwarsa. Menentukan apakah objek IDictionary berisi elemen dengan kunci yang ditentukan. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Kedaluwarsa. Mengembalikan objek IDictionaryEnumerator untuk objek IDictionary. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.Item[Object]	Kedaluwarsa. Mendapatkan atau mengatur elemen dengan kunci yang ditentukan. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.Remove(Object)	Kedaluwarsa. Menghapus elemen dengan kunci yang ditentukan dari objek IDictionary. (Diperoleh dari DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Kedaluwarsa. Mengembalikan enumerator yang melakukan iterasi melalui koleksi. (Diperoleh dari DbConnectionStringBuilder)

Metode Ekstensi

Cast<TResult>(IEnumerable)	Kedaluwarsa. Melemparkan elemen IEnumerable ke jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Kedaluwarsa. Memfilter elemen IEnumerable berdasarkan jenis tertentu.
AsParallel(IEnumerable)	Kedaluwarsa. Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Kedaluwarsa. Mengonversi IEnumerable menjadi IQueryable.

Lihat juga

• Membangun String Koneksi