C#使用ADOX动态创建Access数据库及数据表

Ryan

发布时间：2026-10-14| 2人浏览过

原创

本文演示如何在C#环境中利用COM组件ADOX，通过编程方式动态创建Microsoft Access数据库文件及内部数据表。无需手动打开Access软件，即可自动化完成底层存储结构的初始化。

核心原理

ADOX（ActiveX Data Objects Extensions for DDL）扩展了传统的ADO对象模型，专门用于管理数据库结构（如创建/删除表和字段），而非仅仅查询数据。在C#中调用ADOX需要添加特定的COM引用。

环境准备与引用

在使用前，需在项目中添加以下两个COM组件引用：

Microsoft ADO Ext. 2.8 for DDL and Security
Microsoft ActiveX Data Objects 2.8 Library

添加后，引入命名空间以便访问相关类：

using System.IO;
using ADOX;
using ADODB;

第一步：动态创建Access数据库文件

目的是在没有物理文件的目录下生成一个新的.mdb文件。

具体动作：初始化Catalog并执行Create

1. 入口参数：filePath指定要创建的数据库绝对路径。
2. 判断逻辑：检查文件是否已存在，若不存在则执行创建。
3. 关键连接字符串：指定Jet引擎类型和驱动版本。

创建数据库核心代码：

public static bool CreateAccessDb(string filePath)
{
    // 如果目标文件已存在，通常无需重复创建，视需求可抛出异常或忽略
    if (File.Exists(filePath))
    {
        return true; 
    }
    try 
    { 
        // 使用Catalog对象创建数据库
        Catalog catalog = new Catalog();
        // Provider=4.0为兼容旧版Access的关键点；Engine Type=5代表Access 2000及以上格式
        string strConnect = "Provider=Microsoft.Jet.OLEDB.4.0;" + 
                            "Data Source=" + filePath + ";" + 
                            "Jet OLEDB:Engine Type=5";
        catalog.Create(strConnect);
        return true;
    }
    catch (Exception ex) 
    {
        // 记录错误日志
        return false;
    }
}

注意：以上代码使用了经典的Jet.OLEDB.4.0驱动。如果在64位系统上运行，需确保应用程序平台设置为x86，因为该旧版驱动不支持64位进程。

第二步：在数据库中创建数据表

目的是打开新库，定义表名及各字段属性并保存。

具体动作：连接数据库并操作Table集合

1. 关联连接：创建一个ADODB.Connection并连接到目标数据库文件。
2. 设置目录：将Catalog.ActiveConnection指向该连接。
3. 构建表结构：实例化Table对象，遍历传入的字段数组并追加到表中。

入口参数：filePath数据库路径、tableName表名、colums字段定义数组。
可观察的完成状态：方法执行完毕后，数据库中多出一个包含指定列的空表。

创建表格核心代码：

public static void CreateAccessTable(string filePath, string tableName, params ADOX.Column[] colums)
{
    // 确保数据库存在
    if (!File.Exists(filePath))
    {
        CreateAccessDb(filePath);
    }

    // 1. 打开数据库连接
    ADODB.Connection cn = new ADODB.Connection();
    cn.Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + filePath, null, null, -1);
    
    // 2. 获取目录上下文
    Catalog catalog = new Catalog();
    catalog.ActiveConnection = cn;
    
    // 3. 定义新表
    ADOX.Table table = new ADOX.Table();
    table.Name = tableName;
    
    // 4. 循环添加列定义
    foreach (var column in colums)
    {
        // 必须先将ParentCatalog赋值给Column，否则无法正确写入元数据
        column.ParentCatalog = catalog;
        table.Columns.Append(column, DataTypeEnum.adInteger, 0); 
    }
    
    // 5. 将表追加到目录中
    catalog.Tables.Append(table);
    
    // 6. 释放资源
    cn.Close();
}

第三步：实际调用示例

结合上述两个步骤，可以这样编写调用代码来初始化一个测试表：

调用示例：

// 组装列定义对象
ADOX.Column colId = new ADOX.Column();
colId.Name = "id";
colId.Type = DataTypeEnum.adInteger;

colId.Properties["AutoIncrement"].Value = true; // 设置主键自增

ADOX.Column colName = new ADOX.Column();
colName.Name = "name";
colName.Type = DataTypeEnum.adWChar;
colName.DefinedSize = 50;

// 组合参数进行调用
string dbPath = @"D:\\TestNewDb.mdb";
CreateAccessDb(dbPath);
CreateAccessTable(dbPath, "Users", new ADOX.Column[] { colId, colName });

重要说明：对于长文本类型或自动增长列，必须预先给Column对象的ParentCatalog赋值，即关联之前创建的Catalog实例。此外，设置自增属性时需通过Properties["AutoIncrement"]进行操作。