如何阻止引用项目使用Blazor类库中的内部辅助组件？

1. 利用C#访问修饰符直接限制 #

Blazor组件本质是继承自ComponentBase的C#类，直接将辅助组件的类标记为internal即可——只有当前类库程序集内的代码能访问它们，外部引用项目无法看到这些组件。

如果是单文件Razor组件，可这样设置：

@inherits ComponentBase

@* 内部辅助组件，外部无法引用 *@
<div>@HelperText</div>

@code {
    // 将组件类声明为internal
    internal sealed class InternalCardHelper : ComponentBase
    {
        public string HelperText { get; set; } = "内部辅助文本";
    }
}

如果用代码分离方式（比如InternalCardHelper.razor + InternalCardHelper.razor.cs），直接在代码文件里标记类为internal：

// InternalCardHelper.razor.cs
using Microsoft.AspNetCore.Components;

namespace YourLibrary.Helpers;

internal class InternalCardHelper : ComponentBase
{
    [Parameter]
    public string HelperText { get; set; } = "内部辅助文本";
}

2. 用[Obsolete]标记强制禁止外部使用 #

如果担心内部组件被意外暴露，给组件类加上[Obsolete]特性并设置error: true，外部项目一旦尝试引用该组件就会触发编译错误，从根源阻止使用：

using Microsoft.AspNetCore.Components;
using System;

namespace YourLibrary.Helpers;

[Obsolete("此组件为类库内部辅助组件，禁止外部项目使用", error: true)]
internal class InternalTableHelper : ComponentBase
{
    // 组件逻辑
}

3. 项目结构隔离 #

把所有辅助组件单独放在专属的类库项目（比如YourLibrary.InternalHelpers）中，将这个辅助项目的组件全部标记为internal，再让主类库项目通过项目引用依赖它。外部项目只引用主类库，自然无法访问辅助项目里的组件。

注意事项 #

• 不要在公共组件的参数、返回值中使用内部组件的类型，否则外部项目使用公共组件时会因访问internal类型导致编译错误。
• 确保内部组件所在的命名空间没有被主类库的公共_Imports.razor文件导入，避免意外暴露。

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