OracleConnectionStringBuilder.Item[String] Vlastnost

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Získá nebo nastaví hodnotu přidruženou k zadanému klíči. V jazyce C# je tato vlastnost indexerem.

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

Klíč položky, kterou chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota přidružená k zadanému klíči.

Výjimky

ArgumentNullException

keyword je odkaz s hodnotou null (Nothing v jazyce Visual Basic).

KeyNotFoundException

Pokusili jste se přidat klíč, který v dostupných klíčích neexistuje.

FormatException

Neplatná hodnota v rámci připojovací řetězec (konkrétně pokud byla logická nebo číselná hodnota očekávaná, ale nebyla zadána).

Příklady

Následující kód v konzolové aplikaci vytvoří nový OracleConnectionStringBuilder a přidá páry klíč/hodnota do svého připojovací řetězec pomocí Item[] vlastnosti .

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

Poznámky

OracleConnectionStringBuilder Protože obsahuje slovník s pevnou velikostí, při pokusu o přidání klíče, který ve slovníku neexistuje, se vyvolá KeyNotFoundException. Následující tabulka obsahuje seznam všech možných klíčů v rámci připojovací řetězec a výchozí hodnoty pro každý z nich.

Klíč	Vlastnost	Výchozí hodnota
Zdroj dat (nebo server)	DataSource	Prázdný řetězec
Zachování bezpečnostních údajů (nebo persistsecurityinfo)	PersistSecurityInfo	Ne
Integrované zabezpečení	IntegratedSecurity	Ne
ID uživatele (nebo uživatele nebo UID)	UserID	Prázdný řetězec
Heslo	Password	Prázdný řetězec
Zařazení	Enlist	Ano
Sdružování	Pooling	Ano
Minimální velikost fondu	MinPoolSize	0
Maximální velikost fondu	MaxPoolSize	100
Vynechání názvu připojení Oracle	OmitOracleConnectionName	Ne
Kódování Unicode	Unicode	Ne
Vypršení časového limitu vyrovnávání zatížení (nebo životnost připojení)	LoadBalanceTimeout	0

Viz také

• Vytváření připojovacích řetězců