Compartir a través de


OracleConnectionStringBuilder.Item[String] Propiedad

Definición

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

Valor asociado a la clave especificada.

Excepciones

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

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

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

Se aplica a

Consulte también