Easy-DotNET Easy-DotNET
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
🏠首页
  • 知识地图
  • 源码脑图

    • 总览
    • Program
    • WebApplication
    • Host主机
    • WebHost主机
    • 依赖注入
    • Autofac
    • Middleware中间件
    • RateLimiter限制速率
    • 响应缓存、请求解压缩
  • 设计初衷
  • 克隆
  • 类型转换
  • 日期时间
  • IO流
  • 工具类
  • 语言特性
  • 集合类
  • Codec编码
  • 文本操作
  • 数学
  • 图片
  • 网络
  • Emoji表情
  • C# 12
  • C# 11
  • C# 10
  • C# 9.0
  • C# 8.0
  • C# 早期版本
  • C# 教程
  • ORM
  • 定时任务
  • 日志
  • 认证与授权
  • Swagger
  • 对象映射
  • 熔断重试限流
  • 缓存
  • 注册发现
  • 网关
  • GraphQL
  • 更多
  • Docker

    • 简介
    • Adminer
    • Apisix
    • Apollo
    • Cassandra
    • Cerebro
    • ClickHouse
    • Consul
    • EasyMock
    • Elasticsearch
    • Emqx
    • FastDFS
    • Flink
    • Gitlab
    • Jenkins
    • Jrebel
    • MariaDB
    • MySQL
    • Percona
    • Phpmyadmin
    • PostgreSQL
    • Redis
  • Linux

    • 查看Linux系统信息
    • CentOS7调整磁盘分区
    • IO压测
    • 图形化监控工具Cockpit
  • 总览
  • 列表

    • 算法数据结构
    • API
    • 应用框架
    • 应用模板
    • 操作系统
    • 工作流
    • 入门套件
    • 示例
    • 人工智能
    • 程序集
    • Assets
    • 认证授权
    • Blazor
    • 区块链
    • 书籍
    • 自动构建
    • 报表
    • 缓存
    • 日历
    • 聊天
    • CLI
    • CLR
    • CMS
    • 代码分析和指标
    • 代码片段
    • 压缩
    • 持续集成
    • 密码学
    • 数据库
    • 数据库驱动
    • 日期时间
    • 反编译
    • 部署
    • DirectX
    • 分布式计算
    • DLR
    • 文档
    • 电商支付
    • 模拟器
    • 环境管理
    • ETL
    • 事件消息
    • Exception
    • 扩展
    • 函数式编程
    • 游戏引擎
    • GIS
    • Git工具
    • 绘图
    • GraphQL
    • GUI
    • HTML-CSS
    • HTTP
    • IDE
    • 图片处理
    • 安装工具
    • 交互式编程
    • 国际化
    • 互操作性
    • IoC
    • JS引擎
    • 日志
    • 机器学习和数据科学
    • Markdown
    • 邮件
    • 数学
    • 媒体
    • 指标
    • 微型框架
    • 最小化器
    • MVVM
    • 网络
    • 对象映射
    • Office
    • OpenAI
    • ORM
    • 包管理器
    • PDF
    • 性能分析工具
    • 协议
    • 推送通知
    • SQL构建器
    • 消息队列
    • RPC
    • 响应式编程
    • 实时通信
    • 正则表达式
    • 任务调度
    • SDK和API
    • 搜索引擎
    • 序列化
    • SMS
    • 状态机
    • 静态站点生成
    • 强命名
    • 风格指南
    • 模板引擎
    • 测试
    • 工具
    • 交易
    • UI自动测试
    • Visual Studio 插件
    • Web浏览器
    • Web框架
    • WebServers
    • WebSocket
    • Windows服务
    • WPF
    • 解析器
    • 源码生成
    • 其他
    • 资源
  • AspNetCore面试题
  • Elasticsearch面试题
  • MongoDB面试题
  • MySql面试题
  • Nginx面试题
  • RabbitMQ面试题
  • Redis面试题
  • 设计模式
  • 微服务
🧑‍💻.NET Blog
GitHub (opens new window)
npm
  • 12.0新增功能

    • 主构造函数
    • Lambda表达式参数默认值
    • 类型别名
  • 11.0新增功能

    • 原始字符串字面量(Raw String Literals)
    • 泛型数学支持
    • 泛型属性
    • UTF-8 字符串字面量
    • 字符串中内插换行符
    • 列表匹配模式
    • 文件局部类型
    • 结构体自动默认值
    • string常量支持span模式匹配
    • nameof作用域扩展
    • 数字类型别名
    • ref字段和ref scoped变量
    • 方法组转换成委托功能改进
  • 10.0新增功能

    • 值类型记录
    • 结构类型的改进
    • 内插字符串处理程序
    • 全局using指令
    • 文件范围的命名空间声明
      • 命名空间声明的传统方式
      • 文件作用域命名空间声明的语法
      • 文件作用域命名空间声明的示例
      • 文件作用域命名空间声明的注意事项
      • 结论
    • 扩展属性模式
    • Lambda表达式改进
    • 内插字符串常量
    • Record类型可以密封ToString
    • 改进型明确赋值
    • 析构中进行赋值和声明的改进
    • AsyncMethodBuilder特性
    • CallerArgumentExpression属性诊断
    • 增强型 `#line pragma`
  • 9.0新增功能

    • record关键字定义引用类型
    • 仅限Init的资源库
    • 顶级语句
    • 模式匹配功能增强
    • 性能和互操作性
    • 目标类型的new表达式
    • 静态匿名函数
    • 目标类型条件表达式
    • 协变返回类型
    • ExtensionGetEnumerator支持foreach循环
    • Lambda弃元参数
    • 局部函数属性
    • 模块初始值设定项
    • 扩展分部方法
  • 8.0新增功能

    • readonly实例成员
    • 默认接口成员
    • 模式匹配
    • using指令
    • 本地函数
    • ref结构类型
    • 可为null的引用类型
    • 异步流
    • 范围运算符
    • Null合并赋值
    • where泛型类型约束
    • stackalloc表达式
    • 使用`$`的字符串插值
  • 早期版本

    • C#早期版本历史记录
  • 教程

    • C# 简介
    • C# 环境
    • C# 程序结构
    • C# 基本语法
    • C# 数据类型
    • C# 类型转换
    • C# 变量
    • C# 常量
    • C# 运算符
    • C# 判断
    • C# 循环
    • C# 封装
    • C# 方法
    • C# 可空类型(Nullable)
    • C# 数组(Array)
    • C# 字符串(String)
    • C# 结构(Struct)
    • C# 枚举(Enum)
    • C# 类(Class)
    • C# 继承
    • C# 多态性
    • C# 运算符重载
    • C# 接口(Interface)
    • C# 命名空间(Namespace)
    • C# 预处理器指令
    • C# 正则表达式
    • C# 异常处理
    • C# 文件的输入与输出
    • C# 特性(Attribute)
    • C# 反射(Reflection)
    • C# 属性(Property)
    • C# 索引器(Indexer)
    • C# 委托(Delegate)
    • C# 事件(Event)
    • C# 集合(Collection)
    • C# 泛型(Generic)
    • C# 匿名方法
    • C# 不安全代码
    • C# 多线程
  • CSharp基础
  • 10.0新增功能
一个大西瓜
2023-04-17
目录

文件范围的命名空间声明

C# 10 引入了一种新的命名空间声明方式,即文件作用域命名空间声明(File-scoped namespace declaration)。使用这种方式,你可以将一个文件中的所有成员都置于同一个命名空间中,而无需显式地为每个声明添加命名空间前缀。

# 命名空间声明的传统方式

在 C# 10 之前,我们通常会按照如下方式声明一个命名空间:


namespace MyNamespace {
    // 命名空间成员的定义
}

这种方式的缺点是:如果我们想把一个文件中的所有代码都置于同一个命名空间中,就必须在每个声明中都写出完整的命名空间前缀,如:


namespace MyNamespace {
    class MyClass {
        // 类的定义
    }

    enum MyEnum {
        // 枚举类型的定义
    }
}

如果文件中的成员较多,这样的写法显得很冗长。而且,如果我们想要把这些成员移到另一个命名空间中,也需要逐一修改所有声明中的命名空间前缀,比较麻烦。

# 文件作用域命名空间声明的语法

在 C# 10 中,我们可以使用下面这种新的语法来声明一个文件作用域的命名空间:


namespace MyNamespace;

这种语法与传统方式的区别在于:末尾的花括号变成了分号。这个分号告诉编译器,接下来的代码都属于 MyNamespace 命名空间,直到文件结束或遇到新的命名空间声明为止。

如果在同一个文件中有多个文件作用域命名空间声明,那么它们将被视为同一个命名空间的不同部分。例如:


namespace MyNamespace;

class MyClass {
    // 这个类属于 MyNamespace 命名空间
}

namespace MyNamespace;

enum MyEnum {
    // 这个枚举类型也属于 MyNamespace 命名空间
}

上述代码中,MyClass 类和 MyEnum 枚举类型都属于 MyNamespace 命名空间。

# 文件作用域命名空间声明的示例

下面是一个使用文件作用域命名空间声明的示例。假设我们有一个名为 Person.cs 的文件,其中包含如下代码:


namespace MyNamespace;

class Person {
    public string Name { get; set; }
    public int Age { get; set; }

    public void SayHello() {
        Console.WriteLine($"Hello, my name is {Name}.");
    }
}

在这个示例中,我们使用文件作用域命名空间声明 namespace MyNamespace;,将 Person 类置于 MyNamespace 命名空间中。由于没有显式指定命名空间前缀,因此在类的定义中可以直接使用 Person 这个类型名,而无需加上命名空间前缀。

另外,我们也可以在同一个文件中再添加一个文件作用域命名空间声明,如下所示:


namespace MyNamespace;

class Program {
    static void Main(string[] args) {
        Person person = new Person();
        person.Name = "Tom";
        person.Age = 20;
        person.SayHello();
    }
}

在这个示例中,我们定义了一个名为 Program 的类,它也属于 MyNamespace 命名空间。在 Main 方法中,我们创建了一个 Person 对象并调用了它的 SayHello 方法,这里同样也没有显式指定命名空间前缀。

# 文件作用域命名空间声明的注意事项

需要注意的是,文件作用域命名空间声明只能在文件的顶部进行,不能出现在其他代码的前面。例如,下面这种写法是不合法的:


class MyClass {
    namespace MyNamespace;
}

此外,如果在一个文件中既有传统的命名空间声明方式,又有文件作用域命名空间声明方式,那么它们是相互独立的,不会互相影响。例如:


namespace MyNamespace1 {
    class MyClass1 {
        // 定义1
    }
}

namespace MyNamespace2;

class MyClass2 {
    // 定义2
}

在这个示例中,MyClass1 类属于 MyNamespace1 命名空间,而 MyClass2 类属于 MyNamespace2 命名空间,它们之间没有任何关系。

# 结论

文件作用域命名空间声明是 C# 10 中引入的一个新特性,它允许我们将一个文件中的所有成员都置于同一个命名空间中,从而简化代码编写和修改的难度。同时,文件作用域命名空间声明与传统方式的命名空间声明相互独立,可以混合使用。

上次更新: 2023/04/26, 22:10:06
全局using指令
扩展属性模式

← 全局using指令 扩展属性模式→

Theme by Vdoing | Copyright © 2019-2024 一个大西瓜 | MIT License | 苏ICP备2023013501号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式