OleDbConnection 类
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component System.Data.Common.DbConnection System.Data.OleDb.OleDbConnection
语法
VB
声明
Public NotInheritable Class OleDbConnection _ Inherits DbConnection _ Implements ICloneable, IDbConnection, Idisposable
构造函数：OleDbConnection初始化 OleDbConnection 类的新实例。
OleDbConnection(String)
使用指定的连接字符串初始化 OleDbConnection 类的新实例。
属性
名称
说明
CanRaiseEvents
获取一个指示组件是否可以引发事件的值。 （继承自 Component。）
ConnectionString
获取或设置用于打开数据库的字符串。 （重写 DbConnection.ConnectionString。）
ConnectionTimeout
获取在尝试建立连接时终止尝试并生成错误之前所等待的时间。（重 写 DbConnection.ConnectionTimeout。）
Container
获取 IContainer，它包含 Component。 （继承自 Component。）
Database
获取当前数据库或连接打开后要使用的数据库的名称。 （重写 DbConnection.Database。）
DataSource
获取数据源的服务器名或文件名。（重写 DbConnection.DataSource。）
DbProviderFactory
获取此 DbConnection 的 DbProviderFactory。 （继承自 DbConnection。）
DesignMode
获取一个值，用以指示 Component 当前是否处于设计模式。 （继承自 Component。）
Events
获取附加到此 Component 的事件处理程序的列表。 （继承自 Component。）
Provider
获取在连接字符串的“Provider = ”子句中指定的 OLE DB 提供程序的名称。
ServerVersion
获取一个包含客户端所连接到的服务器的版本的字符串。 （重写 DbConnection.ServerVersion。）
Site
获取或设置 Component 的 ISite。 （继承自 Component。）
State
获取连接的当前状态。 （重写 DbConnection.State。）
方法
名称
说明
BeginDbTransaction
开始数据库事务。 （继承自 DbConnection。）
BeginTransaction
以当前的 IsolationLevel 值开始数据库事务。
BeginTransaction(IsolationLevel)
以指定的隔离级别启动数据库事务。
ChangeDatabase
为打开的 OleDbConnection 更改当前数据库。 （重写 DbConnection.ChangeDatabase(String)。）
Close
关闭到数据源的连接。 （重写 DbConnection.Close。）
CreateCommand
创建并返回一个与该 OleDbConnection 关联的 OleDbCommand 对象。
CreateDbCommand
创建并返回与当前连接关联的 DbCommand 对象。 （继承自 DbConnection。）
CreateObjRef
创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 （继承自 MarshalByRefObject。）
Dispose
释放由 Component 使用的所有资源。 （继承自 Component。）
Dispose(Boolean)
释放 Component 占用的非托管资源，也可以选择释放托管资源。 （继承自 Component。）
EnlistDistributedTransaction
在指定的事务中登记为分布式事务。
EnlistTransaction
在指定的事务中登记为分布式事务。 （重写 DbConnection.EnlistTransaction(Transaction)。）
Equals(Object)
确定指定的 Object 是否等于当前的 Object。 （继承自 Object。）
Finalize
在通过垃圾回收将 Component 回收之前，释放非托管资源并执行其他清理操作。 （继承自 Component。）
GetHashCode
用作特定类型的哈希函数。 （继承自 Object。）
GetLifetimeService
检索控制此实例的生存期策略的当前生存期服务对象。 （继承自 MarshalByRefObject。）
GetOleDbSchemaTable
应用了指定的之后，按照 GUID 的指示从数据源返回架构信息。
GetSchema
返回此 OleDbConnection 的数据源的架构信息。 （重写 DbConnection.GetSchema。）
GetSchema(String)
使用指定的架构名称字符串返回此 OleDbConnection 的数据源的架构信息。 （重写 DbConnection.GetSchema(String)。）
GetSchema(String, String())
使用指定的架构名称字符串和指定的值字符串数组，返回此 OleDbConnection 的数据源的架构信息。（重写 DbConnection.GetSchema(String, String())。）
GetService
返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 （继承自 Component。）
GetType
获取当前实例的 Type。 （继承自 Object。）
InitializeLifetimeService
获取控制此实例的生存期策略的生存期服务对象。 （继承自 MarshalByRefObject。）
MemberwiseClone
创建当前 Object 的浅表副本。 （继承自 Object。）
MemberwiseClone(Boolean)
创建当前 MarshalByRefObject 对象的浅表副本。 （继承自 MarshalByRefObject。）
OnStateChange
引发 StateChange 事件。 （继承自 DbConnection。）
Open
使用 ConnectionString 所指定的属性设置打开数据库连接。 （重写 DbConnection.Open。）
ReleaseObjectPool
指示可在释放最后一个基础连接时释放 OleDbConnection 对象池。
ResetState
更新 OleDbConnection 对象的 State 属性。
ToString
返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 （继承自 Component。）
备注
一个 OleDbConnection 对象，表示到数据源的一个唯一的连接。 在客户端/服务器数据库系统中，它等效于一个到服务器的网络连接。 OleDbConnection 对象的某些方法或属性可能不可用，这取决于本机 OLE DB 提供程序所支持的功能。
当创建 OleDbConnection 的实例时，所有属性都设置为它们的初始值。 有关这些值的列表，请参见 OleDbConnection 构造函数。
可以在一个 OleDbConnection 上打开多个 DataReader。 如果您使用的 OLE DB 提供程序不支持在一个连接上打开多个 DataReader，则提供程序会隐式地为每个 DataReader 额外打开一个连接。
如果 OleDbConnection 超出范围，则不会将其关闭。 因此，必须通过调用 Close 或 Dispose，或通过在 Using 语句中使用 OleDbConnection 对象来显式关闭此连接。
注意
若要部署高性能应用程序，则必须使用连接池。 当使用用于 OLE DB 的 .NET Framework 数据提供程序时，不必启用连接池，因为这由提供程序自动管理。 有关如何配合使用连接池与用于 OLE DB 的 .NET Framework 数据提供程序的更多信息，请参见 OLE DB、ODBC 和 Oracle 连接池 (ADO.NET)。
如果执行 OleDbCommand 的方法生成严重的 OleDbException（例如，SQL Server 严重级别等于或大于 20），OleDbConnection 可能会关闭。 但是，用户可以重新打开连接并继续操作。
创建 OleDbConnection 对象的实例的应用程序可通过设置声明性或命令性安全要求，要求所有直接和间接的调用方都具有访问代码的充分权限。 OleDbConnection 使用 OleDbPermission 对象设置安全要求。 用户可以通过使用 OleDbPermissionAttribute 对象来验证他们的代码是否具有足够的权限。 用户和管理员还可以使用 Caspol.exe（代码访问安全策略工具） 来修改计算机、用户和企业级别的安全策略。 有关更多信息，请参见 代码访问安全性和 ADO.NET。
有关处理来自数据服务器的警告和信息性消息的更多信息，请参见 连接事件 (ADO.NET)。
注意
OleDbConnection 对象不支持设置或检索特定于 OLE DB 提供程序的动态属性。 只支持可在 OLE DB 提供程序的连接字符串中传递的属性。
下面的示例创建一个 OleDbCommand 和一个 OleDbConnection。 OleDbConnection 打开，并设置为 OleDbCommand 的 Connection。 然后，该示例调用 ExecuteNonQuery 并关闭该连接。 若要完成此任务，请为 ExecuteNonQuery 传递一个连接字符串和一个查询字符串，后者是一个 SQL INSERT 语句。
C# VB
Public Sub InsertRow(ByVal connectionString As String, _ ByVal insertSQL As String)
Using connection As New OleDbConnection(connectionString) ' The insertSQL string contains a SQL statement that ' inserts a new row in the source table. Dim command As New OleDbCommand(insertSQL)
' Set the Connection to the new OleDbConnection.
command.Connection = connection
' Open the connection and execute the insert command. Try
connection.Open()
command.ExecuteNonQuery() Catch ex As Exception
Console.WriteLine(ex.Message) End Try
' The connection is automatically closed when the ' code exits the Using block. End Using End Sub
