如何在Biml Studio 2024中引用自定义C#文件？报错求助

问题场景 #

我们编写了测试Biml文件，使用<#@ import namespace="MySQL_Information_Schema" #>引用自定义C#类（用于查询MySQL的information_schema获取表元数据，解决longtext等数据类型兼容性问题），但运行时出现错误：

Error The type or namespace name 'MySQL_Information_Schema' could not be found (are you missing a using directive or an assembly reference?) C:\Users\xxx\AppData\Local\Temp\Varigence\15008\emapbk0t.0.cs 47 11

已将TableInformationSchema.cs添加到Biml Studio的.Net Code区域，相关代码如下：

Biml文件test_query.biml源码 #

<#@ template language="C#" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ import namespace="MySQL_Information_Schema" #>
<# 
string connectionString = "server=myserver;database=mydb;uid=myuser;pwd=mypassword;";

// Fetch metadata dynamically for a given table
var tableInfo = new TableInformationSchema(connectionString, "my_schema", "my_table");
var columns = tableInfo.MetadataOfColumns;
#>

<Biml xmlns="http://schemas.varigence.com/biml.xsd">
    <Tables>
        <Table Name="my_table" SchemaName="my_schema">
            <Columns>
                <# foreach (var column in columns) { #>
                    <Column Name="<#= column.ColumnName #>" DataType="<#= column.DataType #>" />
                <# } #>
            </Columns>
        </Table>
    </Tables>
</Biml>

C#文件TableInformationSchema.cs源码（部分） #

using System;
using MySql.Data.MySqlClient;

namespace MySQL_Information_Schema
{
    public class TableInformationSchema
    {
        public List<Dictionary<string, string>> metadataOfColumns = new List<Dictionary<string, string>>();

        public TableInformationSchema(
            string connectionString,
            string table_schema,
            string table_name
            )
        {
            // SQL query to retrieve metadata for 'sales_order_item' table
            string sqlQuery = @"
SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME, DATA_TYPE 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA = @table_schema 
AND TABLE_NAME = @table_name;";

... omitting the rest of source code ...

解决步骤 #

1. 确认.Net Code文件的编译配置 #

• 在Solution Explorer中找到TableInformationSchema.cs，右键选择Properties，确保Build Action设置为Compile（默认配置，但需确认未被修改）。
• 打开该.cs文件，检查是否存在编译错误（如红色波浪线提示），比如缺少MySql.Data相关引用。

2. 添加MySQL驱动程序集引用 #

你的C#类依赖MySql.Data.MySqlClient，需确保Biml Studio能加载该程序集：

• 右键点击解决方案的References节点，选择Add Reference。
• 在弹出窗口中找到MySql.Data（若未找到，右键解决方案→Manage NuGet Packages，搜索并安装对应版本的MySql.Data包）。
• 确认引用的程序集版本与Biml Studio兼容（2024版本通常支持.NET Framework 4.8及以上）。

3. 验证命名空间与类的访问权限 #

• 确认TableInformationSchema类使用public修饰符（你的代码已满足，但需检查拼写）。
• 确保Biml文件中的<#@ import namespace="MySQL_Information_Schema" #>指令与C#类的命名空间拼写完全一致，无大小写或字符错误。

4. 清理缓存并重新生成解决方案 #

• 点击顶部菜单Build→Clean Solution，随后执行Build Solution。
• 手动删除报错路径中的临时目录（如C:\Users\xxx\AppData\Local\Temp\Varigence\15008\），避免缓存导致的编译异常。

5. 测试完全限定类名 #

若上述步骤无效，可尝试在Biml代码中使用完全限定类名实例化对象，排查是否为import指令问题：

var tableInfo = new MySQL_Information_Schema.TableInformationSchema(connectionString, "my_schema", "my_table");

内容的提问来源于stack exchange，提问作者Mike