OracleConnectionStringBuilder Clase

Referencia

Definición

Espacio de nombres:: System.Data.OracleClient

Ensamblado:: System.Data.OracleClient.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Precaución

OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Proporciona una manera simple de crear y administrar el contenido de las cadenas de conexión que utiliza la clase OracleConnection.

public ref class OracleConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))]
[System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.OracleClient.OracleConnectionStringBuilder+OracleConnectionStringBuilderConverter))>]
[<System.Obsolete("OracleConnectionStringBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OracleConnectionStringBuilder
Inherits DbConnectionStringBuilder

Herencia: Object

DbConnectionStringBuilder
OracleConnectionStringBuilder

Atributos: TypeConverterAttribute ObsoleteAttribute

Ejemplos

La siguiente aplicación de consola compila cadenas de conexión para una base de datos de Oracle. El código usa una OracleConnectionStringBuilder clase para crear la cadena de conexión y, a continuación, pasa la ConnectionString propiedad de la OracleConnectionStringBuilder instancia al constructor de la clase de conexión. En el ejemplo también se analiza una cadena de conexión existente y se muestran varias formas de manipular el contenido de la cadena de conexión.

Nota

Este ejempo incluye una contraseña para demostrar cómo OracleConnectionStringBuilder funciona con cadenas de conexión. Se recomienda que utilice autenticación de Windows en sus aplicaciones. Si necesita utilizar una contraseña en su aplicación, no incluya una contraseña codificada de forma rígida.

// 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()
    {
        // Create a new OracleConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder(GetConnectionString());

        // Note that the input connection string used the
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the OracleConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=OracleDemo;user id=maryc;" +
            "password=pass@word1";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "newPassword";
        builder.PersistSecurityInfo = true;

        // You can refer to connection keys using strings,
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Load Balance Timeout"] = 1000;
        builder["Integrated Security"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Server=OracleDemo;Integrated Security=true";
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    ' Create a new OracleConnectionStringBuilder and
    ' initialize it with a few name/value pairs.
    Dim builder As New OracleConnectionStringBuilder(GetConnectionString())

    ' Note that the input connection string used the 
    ' Server key, but the new connection string uses
    ' the well-known Data Source key instead.
    Console.WriteLine(builder.ConnectionString)

    ' Pass the OracleConnectionStringBuilder an existing 
    ' connection string, and you can retrieve and
    ' modify any of the elements.
    builder.ConnectionString = _
        "server=OracleDemo;user id=Mary;" & _
        "password=*****"
    ' Now that the connection string has been parsed,
    ' you can work with individual items.
    Console.WriteLine(builder.Password)
    builder.Password = "newPassword"
    builder.PersistSecurityInfo = True

    ' You can refer to connection keys using strings, 
    ' as well. When you use this technique (the default
    ' Item property in Visual Basic, or the indexer in C#),
    ' you can specify any synonym for the connection string key
    ' name.
    builder("Server") = "NewDemo"
    builder("Load Balance Timeout") = 1000

    ' The Item property is the default for the class, 
    ' and setting the Item property adds the value to the 
    ' dictionary, if necessary. 
    builder.Item("Integrated Security") = True
    Console.WriteLine(builder.ConnectionString)

    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
  End Sub

  Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,
    ' you can retrieve it from a configuration file. 
    Return "Server=OracleDemo;Integrated Security=True;" & _
      "Unicode=True"
  End Function

End Module

Comentarios

Este tipo está en desuso y se quitará en una versión futura del .NET Framework. Para obtener más información, consulte Oracle y ADO.NET.

Los generadores de cadenas de conexión permiten a los desarrolladores crear cadenas de conexión sintácticamente correctas mediante programación y analizar y recompilar cadenas de conexión existentes mediante propiedades y métodos de la clase . El generador de cadenas de conexión proporciona propiedades fuertemente tipadas correspondientes a los pares clave-valor conocidos permitidos por Oracle. La clase OracleConnectionStringBuilder implementa la interfaz ICustomTypeDescriptor. Esto significa que la clase funciona con Visual Studio diseñadores de .NET en tiempo de diseño. Cuando los desarrolladores usan el diseñador para crear conjuntos de datos fuertemente tipados y conexiones fuertemente tipadas dentro de Visual Studio .NET, la clase generador de cadenas de conexión fuertemente tipadas mostrará las propiedades asociadas a su tipo y también tendrá convertidores que pueden asignar valores comunes para claves conocidas.

Los programadores que tengan que crear cadenas de conexión como parte de las aplicaciones pueden utilizar la clase OracleConnectionStringBuilder para generarlas y modificarlas. La OracleConnectionStringBuilder clase también facilita la administración de cadenas de conexión almacenadas en un archivo de configuración de aplicación.

La clase OracleConnectionStringBuilder realiza comprobaciones para detectar si los pares palabra clave-valor son válidos. Por lo tanto, esta clase no se puede usar para crear cadenas de conexión no válidas. Si intenta agregar pares no válidos, se producirá una excepción. La OracleConnectionStringBuilder clase mantiene una colección fija de sinónimos y, cuando es necesario, puede realizar la traducción necesaria para convertir de un sinónimo al nombre de clave conocido correspondiente. Por ejemplo, al usar la Item[] propiedad para recuperar un valor, puede especificar una cadena que contenga cualquier sinónimo de la clave que necesite. Para obtener una lista de sinónimos aceptables, vea la propiedad Item[].

Controla OracleConnectionStringBuilder los intentos de insertar entradas malintencionadas. Por ejemplo, el código siguiente, con la propiedad predeterminada Item[] (el indexador, en C#) aplica un escape correcto al par clave-valor anidado.

Dim builder As New System.Data. _  
    OracleClient.OracleConnectionStringBuilder  
builder("Data Source") = "OracleDemo"  
builder("Integrated Security") = True  
builder("User ID") = "Mary;NewValue=Bad"  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString)

System.Data.OracleClient.OracleConnectionStringBuilder builder =  
   new System.Data.OracleClient.OracleConnectionStringBuilder();  
builder["Data Source"] = "OracleDemo";  
builder["integrated Security"] = true;  
builder["User ID"] = "Mary;NewValue=Bad";  
System.Diagnostics.Debug.WriteLine(builder.ConnectionString);

El resultado es la siguiente cadena de conexión que controla el valor no válido de forma segura mediante la inclusión del valor de Identificador de usuario entre comillas:

Data Source=OracleDemo;Integrated Security=True;User ID="Mary;NewValue=Bad"

Constructores

OracleConnectionStringBuilder()	Inicializa una nueva instancia de la clase OracleConnectionStringBuilder.
OracleConnectionStringBuilder(String)	Inicializa una nueva instancia de la clase OracleConnectionStringBuilder. La cadena de conexión proporcionada facilita los datos para la información de conexión interna de la instancia.

Propiedades

BrowsableConnectionString	Obtiene o establece un valor que indica si la propiedad ConnectionString está visible en los diseñadores de Visual Studio. (Heredado de DbConnectionStringBuilder)
ConnectionString	Obtiene o establece la cadena de conexión asociada con el DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
Count	Obtiene el número actual de claves que están dentro de la propiedad ConnectionString. (Heredado de DbConnectionStringBuilder)
DataSource	Obtiene o establece el nombre del origen de datos de Oracle al que se va a conectar.
Enlist	Obtiene o establece un valor que indica si el concentrador muestra automáticamente la conexión en el contexto de transacción actual del subproceso de creación.
IntegratedSecurity	Obtiene o establece un valor que indica si en la conexión están especificados "User ID" y "Password" (cuando es `false`) o si se utilizan las actuales credenciales de cuenta de Windows para la autenticación (cuando es `true`).
IsFixedSize	Obtiene un valor que indica si el objeto OracleConnectionStringBuilder tiene un tamaño fijo.
IsReadOnly	Obtiene un valor que indica si DbConnectionStringBuilder es de solo lectura. (Heredado de DbConnectionStringBuilder)
Item[String]	Obtiene o establece el valor asociado a la clave especificada. En C#, esta propiedad es el indizador.
Keys	Obtiene una ICollection que contiene las claves de OracleConnectionStringBuilder.
LoadBalanceTimeout	Obtiene o establece el tiempo mínimo, expresado en segundos, durante el cual la conexión permanece activa en la agrupación de conexiones antes de que se elimine.
MaxPoolSize	Obtiene o establece el número máximo de conexiones permitido en la agrupación de conexiones para esta cadena de conexión específica.
MinPoolSize	Obtiene o establece el número mínimo de conexiones permitido en la agrupación de conexiones para esta cadena de conexión específica.
OmitOracleConnectionName	Obtiene o establece el marcador que habilita las operaciones para deshacer transacciones en versiones anteriores de Oracle (previas a 8.1.7.4.1).
Password	Obtiene o establece la contraseña para la cuenta de Oracle.
PersistSecurityInfo	Obtiene o establece un valor booleano que indica si la información de seguridad confidencial, como la contraseña, no se devuelve como parte de la conexión si la conexión está abierta o alguna vez ha estado abierta.
Pooling	Obtiene o establece un valor booleano que indica si la conexión se va a agrupar o si se va a abrir cada conexión explícitamente cada vez que se solicite.
Unicode	Obtiene o establece un valor booleano que indica si el cliente admite la funcionalidad Unicode disponible para los clientes de Oracle de las versiones recientes, o si no es compatible con Unicode.
UserID	Obtiene o establece el identificador de usuario que se va a utilizar al conectarse a Oracle.
Values	Obtiene un ICollection que contiene los valores de OracleConnectionStringBuilder.

Métodos

Add(String, Object)	Agrega una entrada con la clave y el valor especificados a DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
Clear()	Borra el contenido de la instancia de OracleConnectionStringBuilder.
ClearPropertyDescriptors()	Borra la colección de objetos PropertyDescriptor del DbConnectionStringBuilder asociado. (Heredado de DbConnectionStringBuilder)
ContainsKey(String)	Determina si OracleConnectionStringBuilder contiene una clave específica.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
EquivalentTo(DbConnectionStringBuilder)	Compara la información de conexión de este objeto DbConnectionStringBuilder con la información de conexión del objeto especificado. (Heredado de DbConnectionStringBuilder)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetProperties(Hashtable)	Rellena un Hashtable proporcionado con información sobre todas las propiedades de este DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(String)	Quita la entrada con la clave especificada de la instancia de OracleConnectionStringBuilder.
ShouldSerialize(String)	Indica si la clave especificada existe en esta instancia de OracleConnectionStringBuilder.
ToString()	Devuelve la cadena de conexión asociada a este DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
TryGetValue(String, Object)	Recupera un valor que corresponde a la clave proporcionada por este OracleConnectionStringBuilder.

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Copia los elementos de ICollection en Array, empezando por un índice determinado de Array. (Heredado de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a la interfaz ICollection está sincronizado (es seguro para subprocesos). (Heredado de DbConnectionStringBuilder)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a ICollection. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Devuelve una colección de atributos personalizados para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Devuelve el nombre de clase de esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Devuelve los eventos para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Devuelve un convertidor de tipos para instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Devuelve el evento predeterminado para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Devuelve la propiedad predeterminada para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Devuelve un editor del tipo especificado para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Devuelve los eventos para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Devuelve los eventos de esta instancia de un componente utilizando la matriz de atributos especificada como filtro. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Devuelve las propiedades para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Devuelve las propiedades para esta instancia de un componente usando la matriz de atributos como filtro. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Devuelve un objeto que contiene la propiedad que describe el descriptor de propiedades especificado. (Heredado de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Agrega un elemento con la clave y el valor proporcionados al objeto IDictionary. (Heredado de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Determina si el objeto IDictionary contiene un elemento con la clave especificada. (Heredado de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Devuelve un objeto IDictionaryEnumerator para el objeto IDictionary. (Heredado de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obtiene o establece el elemento con la clave especificada. (Heredado de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Quita el elemento con la clave especificada del objeto IDictionary. (Heredado de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Devuelve un enumerador que recorre en iteración una colección. (Heredado de DbConnectionStringBuilder)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también

Creación de cadenas de conexión