快捷導(dǎo)航

C#11新特性之file關(guān)鍵字的用法教程

更新時(shí)間：2022年12月14日 08:56:13 作者：gmval

C#11?添加了文件作用域類(lèi)型功能：一個(gè)新的?file?修飾符，可以應(yīng)用于任何類(lèi)型定義以限制其只能在當(dāng)前文件中使用。這樣，我們可以在一個(gè)項(xiàng)目中擁有多個(gè)同名的類(lèi)。本文就來(lái)聊聊file關(guān)鍵字的用法，需要的可以參考一下

示例

新建一個(gè)控制臺(tái)程序，添加兩個(gè)類(lèi)，分別為File1.cs和File2.cs

//File1.cs
namespace ConsoleApp
{
    file static class FileWidget
    {
        public static string Widget() => "File1";
    }
    static class GetFileWidget1
    {
        internal static string GetString()=> FileWidget.Widget();
    }
}

//File2.cs
namespace ConsoleApp
{
    file static class FileWidget
    {
        public static string Widget() => "File2";
    }
    static class GetFileWidget2
    {
        internal static string GetString() => FileWidget.Widget();
    }
}

兩個(gè)文件中，定義了相同的FileWidget類(lèi)。但它們只在自己的文件中有效。

這時(shí)，我們調(diào)用兩個(gè)文件對(duì)應(yīng)的方法，可以正常輸出！

using ConsoleApp;

Console.WriteLine(GetFileWidget1.GetString());
Console.WriteLine(GetFileWidget2.GetString());

file不可以與其他修飾符一起使用

需要注意的是：從C# 11開(kāi)始，file關(guān)鍵字是類(lèi)型修飾符，這也意味著它不能與其他修飾符一起使用，比如public、internal、private 等。

file可以修飾的類(lèi)型

file可以在以下類(lèi)型中使用。

class
struct
interface
enum
delegate
record
record struct

file 不可修飾的類(lèi)型

file修飾符不適用于嵌套在父類(lèi)型中的類(lèi)型。它也不適用于方法屬性、事件和字段，但語(yǔ)言設(shè)計(jì)說(shuō)明解釋說(shuō)：“為非類(lèi)型文件范圍的成員留出設(shè)計(jì)空間，以便以后出現(xiàn)。”

例如：

file interface IFileWidget
    {
        file void Widget();
    }

這時(shí)會(huì)有報(bào)錯(cuò)：

file 可以有一個(gè)或多個(gè)同名類(lèi)

在一個(gè)項(xiàng)目中，可以有一個(gè)internal級(jí)別類(lèi)，同時(shí)可以擁有一個(gè)或多個(gè)file級(jí)別的同名類(lèi)。唯一的缺點(diǎn)是文件類(lèi)不能在公共類(lèi)中使用。

例如，我們修改一下File1.cs

namespace ConsoleApp
{
    file static partial class FileWidget
    {
        public static string Widget() => "File1";
    }
    file static partial class FileWidget
    {
        public static string GetWidget() => "File";
    }
    static class GetFileWidget1
    {
        internal static string GetString()=> FileWidget.Widget();
        internal static string GetString2()=> FileWidget.GetWidget();
    }
}

控制臺(tái)輸出一下：

using ConsoleApp;

Console.WriteLine(GetFileWidget1.GetString());
Console.WriteLine(GetFileWidget1.GetString2());
Console.WriteLine(GetFileWidget2.GetString());