OracleConnectionStringBuilder.Item[String] Özellik

Tanım

Ad Alanı:

System.Data.OracleClient

Bütünleştirilmiş Kod:

System.Data.OracleClient.dll

Belirtilen anahtarla ilişkili değeri alır veya ayarlar. C# dilinde bu özellik dizin oluşturucudur.

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

Parametreler

keyword

String

Alınacak veya ayarlanacağı öğenin anahtarı.

Özellik Değeri

Object

Belirtilen anahtarla ilişkili değer.

Özel durumlar

ArgumentNullException

keyword bir null başvurudur (Nothing Visual Basic'te).

KeyNotFoundException

Kullanılabilir anahtarlar içinde bulunmayan bir anahtar eklemeye çalışildi.

FormatException

bağlantı dizesi içinde geçersiz değer (özellikle bir Boole değeri veya sayısal değer beklendiğinde ancak sağlanmadığında).

Örnekler

Aşağıdaki kod, bir konsol uygulamasında yeni OracleConnectionStringBuilder bir oluşturur ve özelliğini kullanarak bağlantı dizesi anahtar/değer çiftleri Item[] ekler.

// 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

Açıklamalar

OracleConnectionStringBuilder sabit boyutlu bir sözlük içerdiğinden, sözlüğün içinde bulunmayan bir anahtar eklemeye çalışmak bir KeyNotFoundExceptionoluşturur. Aşağıdaki tabloda, bağlantı dizesi içindeki tüm olası anahtarlar ve her birinin varsayılan değeri listelenir.

Anahtar	Özellik	Varsayılan değer
Veri Kaynağı (veya sunucu)	DataSource	Boş dize
Kalıcı Güvenlik Bilgileri (veya persistsecurityinfo)	PersistSecurityInfo	Yanlış
Tümleşik Güvenlik	IntegratedSecurity	Yanlış
Kullanıcı Kimliği (veya kullanıcı veya uid)	UserID	Boş dize
Parola	Password	Boş dize
Askere	Enlist	Doğru
Biriktirme	Pooling	Doğru
En Düşük Havuz Boyutu	MinPoolSize	0
En Büyük Havuz Boyutu	MaxPoolSize	100
Oracle Bağlantı Adını Atla	OmitOracleConnectionName	Yanlış
Unicode	Unicode	Yanlış
Yük Dengeleme Zaman Aşımı (veya bağlantı ömrü)	LoadBalanceTimeout	0

Ayrıca bkz.

• Bağlantı Dizeleri Oluşturma