OracleConnectionStringBuilder.Item[String] Właściwość

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Pobiera lub ustawia wartość skojarzona z określonym kluczem. W języku C# ta właściwość jest indeksatorem.

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

Parametry

keyword

String

Klucz elementu do pobrania lub ustawienia.

Wartość właściwości

Object

Wartość skojarzona z określonym kluczem.

Wyjątki

ArgumentNullException

keyword jest odwołaniem o wartości null (Nothing w Visual Basic).

KeyNotFoundException

Podjęto próbę dodania klucza, który nie istnieje w dostępnych kluczach.

FormatException

Nieprawidłowa wartość w parametry połączenia (w szczególności wtedy, gdy wartość logiczna lub liczbowa była oczekiwana, ale nie została podana).

Przykłady

Poniższy kod, w aplikacji konsolowej, tworzy nowe OracleConnectionStringBuilder i dodaje pary klucz/wartość do jej parametry połączenia przy użyciu Item[] właściwości .

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

Uwagi

Ponieważ element OracleConnectionStringBuilder zawiera słownik o stałym rozmiarze, próbuje dodać klucz, który nie istnieje w słowniku, zgłasza błąd KeyNotFoundException. W poniższej tabeli wymieniono wszystkie możliwe klucze w parametry połączenia oraz wartość domyślną dla każdego z nich.

Klucz	Właściwość	Wartość domyślna
Źródło danych (lub serwer)	DataSource	Pusty ciąg
Utrwalanie informacji zabezpieczających (lub utrwalanie informacji o zabezpieczeniach)	PersistSecurityInfo	Fałsz
Zintegrowane zabezpieczenia	IntegratedSecurity	Fałsz
Identyfikator użytkownika (lub użytkownik lub identyfikator uid)	UserID	Pusty ciąg
Hasło	Password	Pusty ciąg
Zarejestrować	Enlist	Prawda
Buforowanie	Pooling	Prawda
Minimalny rozmiar puli	MinPoolSize	0
Maksymalny rozmiar puli	MaxPoolSize	100
Pomiń nazwę połączenia Oracle	OmitOracleConnectionName	Fałsz
Unicode	Unicode	Fałsz
Limit czasu równoważenia obciążenia (lub okres istnienia połączenia)	LoadBalanceTimeout	0

Zobacz też

• Kompilowanie parametrów połączenia