OracleConnectionStringBuilder.Item[String] Properti

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Mendapatkan atau mengatur nilai yang terkait dengan kunci yang ditentukan. Di C#, properti ini adalah pengindeks.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

Parameter

keyword

String

Kunci item yang akan didapatkan atau diatur.

Nilai Properti

Object

Nilai yang terkait dengan kunci yang ditentukan.

Pengecualian

ArgumentNullException

keyword adalah referensi null (Nothing di Visual Basic).

KeyNotFoundException

Mencoba menambahkan kunci yang tidak ada di dalam kunci yang tersedia.

FormatException

Nilai tidak valid dalam string koneksi (khususnya, ketika nilai Boolean atau numerik diharapkan tetapi tidak disediakan).

Contoh

Kode berikut, dalam aplikasi konsol, membuat baru OracleConnectionStringBuilder dan menambahkan pasangan kunci/nilai ke string koneksi, menggunakan Item[] properti .

// 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()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

Keterangan

OracleConnectionStringBuilder Karena berisi kamus ukuran tetap, mencoba menambahkan kunci yang tidak ada dalam kamus KeyNotFoundExceptionmelempar . Tabel berikut mencantumkan semua kunci yang mungkin dalam string koneksi, dan nilai default untuk masing-masing kunci.

Kunci	Properti	Nilai default
Sumber Data (atau server)	DataSource	String kosong
Pertahankan Info Keamanan (atau persistsecurityinfo)	PersistSecurityInfo	FALSE
Keamanan Terintegrasi	IntegratedSecurity	FALSE
ID Pengguna (atau pengguna atau uid)	UserID	String kosong
Kata sandi	Password	String kosong
Daftar	Enlist	True
Penggabungan	Pooling	True
Ukuran Kumpulan Min	MinPoolSize	0
Ukuran Kumpulan Maks	MaxPoolSize	100
Hilangkan Nama Koneksi Oracle	OmitOracleConnectionName	Salah
Unicode	Unicode	Salah
Batas Waktu Keseimbangan Beban (atau masa pakai koneksi)	LoadBalanceTimeout	0

Lihat juga

• Membangun String Koneksi