OracleConnectionStringBuilder.Item[String] Propiedad

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Obtiene o establece el valor asociado a la clave especificada. En C#, esta propiedad es el indizador.

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

Parámetros

keyword

String

Clave del elemento que se va a obtener o establecer.

Valor de propiedad

Object

Valor asociado a la clave especificada.

Excepciones

ArgumentNullException

keyword es una referencia nula (Nothing en Visual Basic).

KeyNotFoundException

Se ha intentado agregar una clave que no existe en el conjunto de claves disponibles.

FormatException

Valor no válido dentro de la cadena de conexión (concretamente cuando se esperaba un valor booleano o numérico, pero no se ha proporcionado).

Ejemplos

El siguiente código, en una aplicación de consola, crea una nueva OracleConnectionStringBuilder y agrega pares clave-valor a sus cadenas de conexión, utilizando la propiedad Item[].

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

Comentarios

Dado que OracleConnectionStringBuilder contiene un diccionario de tamaño fijo, cualquier intento de agregar una clave que no exista en el diccionario producirá una excepción KeyNotFoundException. En la tabla siguiente se enumeran todas las claves posibles dentro del cadena de conexión y el valor predeterminado de cada una.

Clave	Propiedad	Valor predeterminado
Origen de datos (o servidor)	DataSource	cadena vacía.
Conservar información de seguridad (o persistsecurityinfo)	PersistSecurityInfo	Falso
Seguridad integrada	IntegratedSecurity	Falso
Id. de usuario (o usuario o uid)	UserID	cadena vacía.
Contraseña	Password	cadena vacía.
Dar de alta	Enlist	Verdadero
Agrupación	Pooling	Verdadero
Min Pool Size	MinPoolSize	0
Max Pool Size	MaxPoolSize	100
Omitir el nombre de conexión de Oracle	OmitOracleConnectionName	Falso
Unicode	Unicode	Falso
Tiempo de espera de equilibrio de carga (o duración de la conexión)	LoadBalanceTimeout	0

Consulte también

• Creación de cadenas de conexión