OracleConnectionStringBuilder Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Precaución

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

Proporciona una manera sencilla de crear y administrar el contenido de las cadenas de conexión usadas por la clase OracleConnection.

public ref class OracleConnectionStringBuilder sealed : 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))>]
[<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

Comentarios

Este tipo está en desuso y se quitará en una versión futura de .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ácticasmente correctas mediante programación y analizar y recompilar las 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 diseñadores de .NET de Visual Studio en tiempo de diseño. Cuando los desarrolladores usan el diseñador para compilar DataSets fuertemente tipados y conexiones fuertemente tipadas dentro de Visual Studio .NET, la clase de generador de cadenas de conexión fuertemente tipadas mostrará las propiedades asociadas con su tipo y también tendrá convertidores que pueden asignar valores comunes para claves conocidas.

Los desarrolladores que necesitan crear cadenas de conexión como parte de las aplicaciones pueden usar la clase OracleConnectionStringBuilder para compilar y modificar cadenas de conexión. La clase OracleConnectionStringBuilder también facilita la administración de cadenas de conexión almacenadas en un archivo de configuración de aplicación.

El OracleConnectionStringBuilder realiza comprobaciones de pares clave-valor 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 clase OracleConnectionStringBuilder 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 propiedad Item[] para recuperar un valor, puede especificar una cadena que contenga cualquier sinónimo de la clave que necesite. Consulte la propiedad Item[] para obtener una lista completa de sinónimos aceptables.

El OracleConnectionStringBuilder controla los intentos de insertar entradas malintencionadas. Por ejemplo, el código siguiente, con la propiedad Item[] predeterminada (el indexador, en C#), escapa correctamente al par clave-valor anidado.

Dim builder As New System.Data. _
    OracleClient.OracleConnectionStringBuilder
builder("Data Source") = "OracleDemo;NewValue=Bad"
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 Id. de usuario entre comillas:

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

Advertencia

Microsoft no recomienda proporcionar el nombre de usuario y la contraseña directamente, ya que es un patrón inseguro. Siempre que sea posible, use flujos de autenticación más seguros, como identidades administradas para recursos de Azureo autenticación de Windows para SQL Server.

Constructores

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

Propiedades

BrowsableConnectionString	Obsoletos. Obtiene o establece un valor que indica si la propiedad ConnectionString está visible en los diseñadores de Visual Studio. (Heredado de DbConnectionStringBuilder)
ConnectionString	Obsoletos. Obtiene o establece la cadena de conexión asociada al DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
Count	Obsoletos. Obtiene el número actual de claves contenidas en la propiedad ConnectionString. (Heredado de DbConnectionStringBuilder)
DataSource	Obsoletos. Obtiene o establece el nombre del origen de datos de Oracle al que se va a conectar.
Enlist	Obsoletos. Obtiene o establece un valor que indica si el agrupador inscribe automáticamente la conexión en el contexto de transacción actual del subproceso de creación.
IntegratedSecurity	Obsoletos. Obtiene o establece un valor que indica si se especifican "Id. de usuario" y "Contraseña" en la conexión (cuando false) o si las credenciales actuales de la cuenta de Windows se usan para la autenticación (cuando true).
IsFixedSize	Obsoletos. Obtiene un valor que indica si el OracleConnectionStringBuilder tiene un tamaño fijo.
IsReadOnly	Obsoletos. Obtiene un valor que indica si el DbConnectionStringBuilder es de solo lectura. (Heredado de DbConnectionStringBuilder)
Item[String]	Obsoletos. Obtiene o establece el valor asociado a la clave especificada. En C#, esta propiedad es el indexador.
Keys	Obsoletos. Obtiene un ICollection que contiene las claves del OracleConnectionStringBuilder.
LoadBalanceTimeout	Obsoletos. Obtiene o establece el tiempo mínimo, en segundos, para que la conexión resida en el grupo de conexiones antes de quitarla.
MaxPoolSize	Obsoletos. Obtiene o establece el número máximo de conexiones permitidas en el grupo de conexiones para esta cadena de conexión específica.
MinPoolSize	Obsoletos. Obtiene o establece el número mínimo de conexiones permitidas en el grupo de conexiones para esta cadena de conexión específica.
OmitOracleConnectionName	Obsoletos. Obtiene o establece la marca que habilita las reversiones de transacciones en versiones anteriores de Oracle (anteriores a la versión 8.1.7.4.1).
Password	Obsoletos. Obtiene o establece la contraseña de la cuenta de Oracle.
PersistSecurityInfo	Obsoletos. Obtiene o establece un valor booleano que indica si la información confidencial de seguridad, como la contraseña, no se devuelve como parte de la conexión si la conexión está abierta o alguna vez está en un estado abierto.
Pooling	Obsoletos. Obtiene o establece un valor booleano que indica si la conexión se agrupará o si cada conexión se abrirá explícitamente cada vez que se solicite la conexión.
Unicode	Obsoletos. Obtiene o establece un valor booleano que indica si el cliente admite la funcionalidad Unicode disponible en clientes de Oracle posteriores o si no es compatible con Unicode.
UserID	Obsoletos. Obtiene o establece el identificador de usuario que se va a usar al conectarse a Oracle.
Values	Obsoletos. Obtiene un ICollection que contiene los valores de la OracleConnectionStringBuilder.

Métodos

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

Implementaciones de interfaz explícitas

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

Métodos de extensión

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

Consulte también

• creación de cadenas de conexión