OracleConnectionStringBuilder 类

定义

命名空间:

System.Data.OracleClient

程序集:

System.Data.OracleClient.dll

注意

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

提供一种创建和管理 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

继承

Object

DbConnectionStringBuilder

OracleConnectionStringBuilder

属性

TypeConverterAttribute ObsoleteAttribute

注解

此类型已弃用，将在 .NET Framework 的未来版本中删除。 有关详细信息，请参阅 Oracle 和 ADO.NET。

连接字符串生成器允许开发人员以编程方式创建语法正确的连接字符串，以及使用类的属性和方法分析和重新生成现有连接字符串。 连接字符串生成器提供与 Oracle 允许的已知键/值对对应的强类型属性。 OracleConnectionStringBuilder 类实现 ICustomTypeDescriptor 接口。 这意味着该类在设计时适用于 Visual Studio .NET 设计器。 当开发人员使用设计器在 Visual Studio .NET 中生成强类型化 数据集 和强类型连接时，强类型连接字符串生成器类将显示与其类型关联的属性，并且还具有可映射已知键的常见值的转换器。

需要创建作为应用程序的一部分的连接字符串的开发人员可以使用 OracleConnectionStringBuilder 类来生成和修改连接字符串。 OracleConnectionStringBuilder 类还可以轻松地管理存储在应用程序配置文件中的连接字符串。

OracleConnectionStringBuilder 会检查有效的键/值对。 因此，此类不能用于创建无效的连接字符串。 尝试添加无效对将引发异常。 OracleConnectionStringBuilder 类维护一个固定的同义词集合，如果需要，可以执行所需的转换，以便从同义词转换为相应的已知密钥名称。 例如，使用 Item[] 属性检索值时，可以指定包含所需密钥的任何同义词的字符串。 有关可接受同义词的完整列表，请参阅 Item[] 属性。

OracleConnectionStringBuilder 处理插入恶意条目的尝试。 例如，以下代码使用默认 Item[] 属性（索引器，以 C# 为单位），正确转义嵌套键/值对。

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);

结果是以下连接字符串，它通过将用户 ID 值括在引号中，以安全的方式处理无效值：

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

警告

Microsoft不建议直接提供用户名和密码，因为它是不安全模式。 如果可能，请使用更安全的身份验证流，例如 Azure 资源的托管标识，或 SQL Server 的 Windows 身份验证。

构造函数

OracleConnectionStringBuilder()	已过时. 初始化 OracleConnectionStringBuilder 类的新实例。
OracleConnectionStringBuilder(String)	已过时. 初始化 OracleConnectionStringBuilder 类的新实例。 提供的连接字符串为实例的内部连接信息提供数据。

属性

BrowsableConnectionString	已过时. 获取或设置一个值，该值指示 ConnectionString 属性在 Visual Studio 设计器中是否可见。 (继承自 DbConnectionStringBuilder)
ConnectionString	已过时. 获取或设置与 DbConnectionStringBuilder关联的连接字符串。 (继承自 DbConnectionStringBuilder)
Count	已过时. 获取 ConnectionString 属性中包含的当前键数。 (继承自 DbConnectionStringBuilder)
DataSource	已过时. 获取或设置要连接到的 Oracle 数据源的名称。
Enlist	已过时. 获取或设置一个值，该值指示池器是否在创建线程的当前事务上下文中自动登记连接。
IntegratedSecurity	已过时. 获取或设置一个值，该值指示在连接（false时）中指定了“用户 ID”和“密码”，或者当前 Windows 帐户凭据是否用于身份验证（true时）。
IsFixedSize	已过时. 获取一个值，该值指示 OracleConnectionStringBuilder 是否具有固定大小。
IsReadOnly	已过时. 获取一个值，该值指示 DbConnectionStringBuilder 是否为只读。 (继承自 DbConnectionStringBuilder)
Item[String]	已过时. 获取或设置与指定键关联的值。 在 C# 中，此属性是索引器。
Keys	已过时. 获取一个 ICollection，其中包含 OracleConnectionStringBuilder中的键。
LoadBalanceTimeout	已过时. 获取或设置连接在删除之前在连接池中生存的最短时间（以秒为单位）。
MaxPoolSize	已过时. 获取或设置此特定连接字符串的连接池中允许的最大连接数。
MinPoolSize	已过时. 获取或设置此特定连接字符串的连接池中允许的最小连接数。
OmitOracleConnectionName	已过时. 获取或设置在早期版本的 Oracle 上启用事务回滚的标志（8.1.7.4.1 之前）。
Password	已过时. 获取或设置 Oracle 帐户的密码。
PersistSecurityInfo	已过时. 获取或设置一个布尔值，该值指示在连接处于打开状态或以前处于打开状态时，不会返回安全敏感信息（如密码）作为连接的一部分。
Pooling	已过时. 获取或设置一个布尔值，该值指示连接是共用的，还是每次请求连接时都会显式打开每个连接。
Unicode	已过时. 获取或设置一个布尔值，该值指示客户端是否支持在以后的 Oracle 客户端中可用的 Unicode 功能，或者它是非 Unicode 感知的。
UserID	已过时. 获取或设置连接到 Oracle 时要使用的用户 ID。
Values	已过时. 获取一个 ICollection，其中包含 OracleConnectionStringBuilder中的值。

方法

Add(String, Object)	已过时. 将具有指定键和值的条目添加到 DbConnectionStringBuilder中。 (继承自 DbConnectionStringBuilder)
Clear()	已过时. 清除 OracleConnectionStringBuilder 实例的内容。
ClearPropertyDescriptors()	已过时. 清除关联 DbConnectionStringBuilder上 PropertyDescriptor 对象的集合。 (继承自 DbConnectionStringBuilder)
ContainsKey(String)	已过时. 确定 OracleConnectionStringBuilder 是否包含特定密钥。
Equals(Object)	已过时. 确定指定的对象是否等于当前对象。 (继承自 Object)
EquivalentTo(DbConnectionStringBuilder)	已过时. 将此 DbConnectionStringBuilder 对象中的连接信息与所提供的对象中的连接信息进行比较。 (继承自 DbConnectionStringBuilder)
GetHashCode()	已过时. 用作默认哈希函数。 (继承自 Object)
GetProperties(Hashtable)	已过时. 用有关此 DbConnectionStringBuilder的所有属性的信息填充提供的 Hashtable。 (继承自 DbConnectionStringBuilder)
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	已过时. 创建当前 Object的浅表副本。 (继承自 Object)
Remove(String)	已过时. 从 OracleConnectionStringBuilder 实例中删除具有指定键的条目。
ShouldSerialize(String)	已过时. 指示此 OracleConnectionStringBuilder 实例中是否存在指定的键。
ToString()	已过时. 返回与此 DbConnectionStringBuilder关联的连接字符串。 (继承自 DbConnectionStringBuilder)
TryGetValue(String, Object)	已过时. 从此 OracleConnectionStringBuilder检索与提供的键对应的值。

显式接口实现

ICollection.CopyTo(Array, Int32)	已过时. 从特定 Array 索引开始，将 ICollection 的元素复制到 Array。 (继承自 DbConnectionStringBuilder)
ICollection.IsSynchronized	已过时. 获取一个值，该值指示是否同步对 ICollection 的访问（线程安全）。 (继承自 DbConnectionStringBuilder)
ICollection.SyncRoot	已过时. 获取可用于同步对 ICollection的访问的对象。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	已过时. 返回此组件的实例的自定义属性集合。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	已过时. 返回组件的此实例的类名。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	已过时. 返回组件的此实例的名称。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	已过时. 返回组件的此实例的类型转换器。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	已过时. 返回此组件实例的默认事件。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	已过时. 返回组件的此实例的默认属性。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	已过时. 返回此组件的实例的指定类型的编辑器。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	已过时. 返回组件的此实例的事件。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	已过时. 使用指定的属性数组作为筛选器返回组件的此实例的事件。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	已过时. 返回组件的此实例的属性。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	已过时. 使用属性数组作为筛选器返回组件的此实例的属性。 (继承自 DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	已过时. 返回一个对象，该对象包含指定属性描述符描述符描述的属性。 (继承自 DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	已过时. 将具有提供的键和值的元素添加到 IDictionary 对象。 (继承自 DbConnectionStringBuilder)
IDictionary.Contains(Object)	已过时. 确定 IDictionary 对象是否包含具有指定键的元素。 (继承自 DbConnectionStringBuilder)
IDictionary.GetEnumerator()	已过时. 返回 IDictionary 对象的 IDictionaryEnumerator 对象。 (继承自 DbConnectionStringBuilder)
IDictionary.Item[Object]	已过时. 获取或设置具有指定键的元素。 (继承自 DbConnectionStringBuilder)
IDictionary.Remove(Object)	已过时. 从 IDictionary 对象中删除具有指定键的元素。 (继承自 DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	已过时. 返回循环访问集合的枚举器。 (继承自 DbConnectionStringBuilder)

扩展方法

Cast<TResult>(IEnumerable)	已过时. 将 IEnumerable 的元素强制转换为指定类型。
OfType<TResult>(IEnumerable)	已过时. 根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	已过时. 启用查询的并行化。
AsQueryable(IEnumerable)	已过时. 将 IEnumerable 转换为 IQueryable。

另请参阅

• 生成连接字符串