** 使用 Ado.net ** ** 获取数据库架构信息 **
秋 枫 2004-7-3
在开发的时候有时需要获取数据库架构信息来得到数据库的一些其他信息,比如存储过程、视图、表、字段的类型、备注说明等。通过 OleDb.NET 数据提供程序可以比较简洁的实现这一点。
一、 OleDbConnection 的 GetOleDbSchemaTable 方法
在 Ado.net 的对象模型的该对象充当了与数据源之间的连接,通过 Connection 对象来连接数据库或者从数据库断开以释放宝贵的资源。这里我们需要用到的是 OleDbConnection 对象的 GetOleDbSchemaTable 方法,
定义如下:
public DataTable GetOleDbSchemaTable( Guid schema,object[] restrictions);
方法返回一个 DataTable 对象;
第一个参数是 OleDbSchemaGuid 的枚举值,是用来指定架构信息类型,可以根据某一个值来决定所需的架构类型,如表、列、视图等 , 具体可以参考 MSDN ;
第二个参数为 Restrictions 的参数,作为一个 oject 数组数据类型,起到过滤的作用,如果把第二个参数设置为 null ,那就返回指定的 OleDbSchemaGuid 枚举的所有信息了。
下面用示例程序来进行相关说明,示例界面如下:
整个窗体包括:
一个 TextBox ,用来输入数据库连接字符串;
一个 DataGrid ,用来显示架构信息;
查看按钮,点击获取架构信息。
这里以 SqlServer 的 Northwind 数据库为例,在查看按钮事件中进行了如下处理:
private void buttonOK_Click( object sender, System.EventArgs e)
{
this .dataGridSchema.DataSource = GetSqlDbSchemaUsingOleDbConnection ( this .textBoxConnString.Text.Trim());
}
通过文本框把连接字符串传入 GetSqlDbSchemaUsingOleDbConnection 函数,由 OleDbConnection 对象来连接数据库,并获取构架信息,
private DataTable GetSqlDbSchemaUsingOleDbConnection( string connString)
{
OleDbConnection myConn = new OleDbConnection(connString);
myConn.Open();
DataTable table1 = myConn.GetOleDbSchemaTable(OleDbSchemaGuid.Columns, null );
myConn.Close();
return table1;
}
上面的函数返回数据库的所有字段,下面来看看如何通过 Restrictions 参数来过滤信息;
参数数据可以定义为
object [] restrictions =
new object []{"TABLE_CATALOG","TABLE_SCHEMA","TABLE_NAME","COLUMN_NAME"};
具体可参考 MSDN 文档。
对上面函数进行修改,我们只获取 Northwind 数据库 Customers 表的信息:
private DataTable GetSqlDbSchemaUsingOleDbConnection( string connString)
{
OleDbConnection myConn = new OleDbConnection(connString);
object [] restrictions = new object []{"Northwind","dbo","Customers", null };
myConn.Open();
DataTable table1 = myConn.GetOleDbSchemaTable(OleDbSchemaGuid.Columns,restrictions);
myConn.Close();
return table1;
}
另外对于 Access 数据库架构信息的获取也可以通过上面的方法来完成,
private DataTable GetMdbSchemaUsingOleDbConnection( string connString)
{
OleDbConnection myConn = new OleDbConnection(connString);
myConn.Open();
DataTable table1 = myConn.GetOleDbSchemaTable(OleDbSchemaGuid.Columns, null );
myConn.Close();
return table1;
}
前面的界面图示就是执行结果,这里我用的是 Access 2003 。
二. OleDbDataReader 的 GetSchemaTable 方法
另外一个获取架构的方法是使用 OleDbDataReader 的 GetSchemaTable 方法,
public virtual DataTable GetSchemaTable();
该方法需要结合 OleDbCommand.ExecuteReader 的一个重载方法才能完成,可以设置重载方法的唯一参数,
public OleDbDataReader ExecuteReader(CommandBehavior behavior);
CommandBehavior 为一枚举对象,定义为
[Flags]
[Serializable]
public enum CommandBehavior
CommandBehavior.SchemaOnly :只返回列信息,不影响数据库状态;
CommandBehavior.KeyInfo :返回列和主键信息。执行此查询时不锁定选定的行。
如果使用 CommandBehavior.SchemaOnly 就不需要再加 CommandBehavior.KeyInfo 了。
下面是演示代码:
private DataTable GetSchemaUsingOleDbDataReader( string connString)
{
OleDbConnection myConn = new OleDbConnection(connString);
DataTable table1 = null ;
try
{
OleDbCommand cmd = new OleDbCommand("Select * from Customers",myConn);
myConn.Open();
OleDbDataReader dataReader = cmd.ExecuteReader(CommandBehavior.SchemaOnly);
table1 = dataReader.GetSchemaTable();
dataReader.Close();
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
finally
{
if (myConn.State != ConnectionState.Closed)
myConn.Close();
myConn.Dispose();
}
return table1;
}
该方法返回了 Customers 表的架构信息,当然,如果连接到 Access 数据库,上面的函数只需修改一下连接字符串和查询字符串就可以正确执行。
三、其他补充
我们这里所说的是通过 OleDb.NET 来实现数据库架构信息的获取。对于特定的数据提供程序 Sql Client.NET 和 Oracle Client.NET 等还可以通过其他手段实现。
比如:
在 Sql Server 中可以通过信息架构视图来获取数据:
SELECT * FROM INFORMATION_SCHEMA.TABLES
获取表名的清单:
SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'BASE TABLE'
获取视图名清单:
SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_TYPE = 'VIEW'
还有获取列,存储过程等,具体可以查看 SQL SERVER 的联机帮助。
在 Oracle 数据库中可以通过查询 Oracle 数据字典来获取这些信息,具体可以参考 Oracle 的相关文档。
本文参考:《 MSDN 》、《 ADO.NET Core Reference 》、《 Sql Server 2000 联机丛书》