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 OracleConnection kelas .

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

Contoh

Aplikasi konsol berikut membangun string koneksi untuk database Oracle. Kode menggunakan OracleConnectionStringBuilder kelas untuk membuat string koneksi, lalu meneruskan ConnectionString properti OracleConnectionStringBuilder instans ke konstruktor kelas koneksi. Contohnya juga mengurai string koneksi yang ada, dan menunjukkan berbagai cara untuk memanipulasi konten string koneksi.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara OracleConnectionStringBuilder kerja dengan string koneksi. Di aplikasi Anda, kami sarankan Anda menggunakan Autentikasi Windows. Jika Anda harus menggunakan kata sandi, jangan sertakan kata sandi yang dikodekan secara permanen di aplikasi Anda.

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

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 sintaksis, dan untuk mengurai dan membangun kembali string koneksi yang ada, menggunakan properti dan metode kelas . Penyusun string koneksi menyediakan properti yang sangat ditik sesuai dengan pasangan kunci/nilai yang diketahui yang diizinkan oleh Oracle. Kelas OracleConnectionStringBuilder menerapkan antarmuka ICustomTypeDescriptor. Ini berarti bahwa kelas berfungsi dengan desainer Visual Studio .NET pada waktu desain. Ketika pengembang menggunakan perancang untuk membangun Himpunan Data yang ditik dengan kuat dan koneksi yang sangat ditik dalam Visual Studio .NET, kelas penyusun string koneksi yang sangat ditik akan menampilkan properti yang terkait dengan jenisnya dan juga akan memiliki pengonversi yang dapat memetakan nilai umum untuk kunci yang diketahui.

Pengembang perlu membuat string koneksi sebagai bagian dari aplikasi dapat menggunakan OracleConnectionStringBuilder kelas untuk membangun dan memodifikasi string koneksi. Kelas ini 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 memberikan pengecualian. Kelas OracleConnectionStringBuilder mempertahankan koleksi sinonim tetap, dan jika diperlukan, dapat melakukan terjemahan yang diperlukan untuk mengonversi dari sinonim ke nama kunci terkenal yang sesuai. Misalnya, saat Anda menggunakan Item[] properti untuk mengambil nilai, Anda dapat menentukan string yang berisi sinonim apa pun untuk kunci yang Anda butuhkan. Item[] Lihat properti untuk daftar lengkap sinonim yang dapat diterima.

Handel OracleConnectionStringBuilder mencoba menyisipkan entri berbahaya. Misalnya, kode berikut, menggunakan properti default Item[] (pengindeks, di C#) dengan benar keluar dari pasangan kunci/nilai berlapis.

Dim builder As 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)  

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"  

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 ConnectionString properti terlihat di perancang 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 ConnectionString properti . (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 alur pembuatan saat ini.
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 (ketika 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. ICollection Mendapatkan 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 di kumpulan koneksi untuk string koneksi khusus ini.
MinPoolSize	Kedaluwarsa. Mendapatkan atau mengatur jumlah minimum koneksi yang diizinkan di 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 menetapkan 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 nanti, atau jika tidak sadar Unicode.
UserID	Kedaluwarsa. Mendapatkan atau mengatur ID pengguna yang akan digunakan saat menyambungkan ke Oracle.
Values	Kedaluwarsa. ICollection Mendapatkan yang berisi nilai dalam OracleConnectionStringBuilder.

Metode

Add(String, Object)	Kedaluwarsa. Menambahkan entri dengan kunci dan nilai yang ditentukan ke DbConnectionStringBuilderdalam . (Diperoleh dari DbConnectionStringBuilder)
Clear()	Kedaluwarsa. Menghapus konten instans OracleConnectionStringBuilder .
ClearPropertyDescriptors()	Kedaluwarsa. Menghapus kumpulan PropertyDescriptor objek pada yang terkait DbConnectionStringBuilder. (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 ini DbConnectionStringBuilder dengan informasi koneksi dalam objek yang disediakan. (Diperoleh dari DbConnectionStringBuilder)
GetHashCode()	Kedaluwarsa. Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperties(Hashtable)	Kedaluwarsa. Mengisi yang disediakan Hashtable dengan informasi tentang semua properti ini DbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder)
GetType()	Kedaluwarsa. Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Kedaluwarsa. Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
Remove(String)	Kedaluwarsa. Menghapus entri dengan kunci yang ditentukan dari OracleConnectionStringBuilder instans.
ShouldSerialize(String)	Kedaluwarsa. Menunjukkan apakah kunci yang ditentukan ada dalam instans ini OracleConnectionStringBuilder .
ToString()	Kedaluwarsa. Mengembalikan string koneksi yang terkait dengan iniDbConnectionStringBuilder. (Diperoleh dari DbConnectionStringBuilder)
TryGetValue(String, Object)	Kedaluwarsa. Mengambil nilai yang sesuai dengan kunci yang disediakan dari ini OracleConnectionStringBuilder.

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Kedaluwarsa. Menyalin elemen ICollection ke Array, dimulai dari indeks tertentu Array . (Diperoleh dari DbConnectionStringBuilder)
ICollection.IsSynchronized	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan ICollection (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 dari 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 IDictionary objek . (Diperoleh dari DbConnectionStringBuilder)
IDictionary.Contains(Object)	Kedaluwarsa. Menentukan apakah IDictionary objek berisi elemen dengan kunci yang ditentukan. (Diperoleh dari DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Kedaluwarsa. Mengembalikan IDictionaryEnumerator objek untuk IDictionary objek . (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 IDictionary objek . (Diperoleh dari DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Kedaluwarsa. Mengembalikan enumerator yang berulang melalui koleksi. (Diperoleh dari DbConnectionStringBuilder)

Metode Ekstensi

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

Lihat juga

• Membangun String Koneksi