文章目录
一、前言
前段时间开始接触在VS下用C#开发（其实是WPF，只是说到VS，往往会扯上C#，而且WPF框架的后台语言确实主要是C#），新建一个WPF应用程序后，在MainWindow.xaml.cs文件开头会有一堆using xxx的语句。
因为以前接触过C++，所以对using也不陌生，毕竟using namespace std这样的语句在C++中非常常见。所以很自然的，也很想当然的认为这边的用法和C++一样，就是引入命名空间，不必深究。
不过，在最近学习EF Core的过程中，在上下文的使用时，看到了这样的语句，觉得很陌生：
using (var context = new MyContext ())
{
...
}
其实，这个用法的含义也不难猜，我当时觉得应该是跟context的作用域/生命周期有关，大概是想用完就销毁，不再占用资源。但是呢，知识点这种东西不能一直猜啊，万一猜错了呢，所以我决定还是系统地学习一下。
二、using学习
首先C#中的using是个关键字。
啥是关键字呢？
一开始接触编程时，老师就有教，编程的时候，并不是所有的单词都能拿来命名用的，有一部分单词是保留的，
对编译器有着特殊含义的，那这些保留的、预定义的单词你可以认为就是关键字（但不绝对）。
using关键字有两个主要的用途：
- using语句定义了一个作用域，在作用域的尾部将会释放对象
- using指令为命名空间创建别名或导入其他命名空间中定义的类型
这边两个用途就对应于前言部分的两种情况。接下来将两种用途展开讲讲。
1. using指令
using指令允许你使用在命名空间中定义的类型，而无需指定该类型的全名（有点C系语言中include的味道）。using指令会导入命名空间中的所有类型，如下所示：
using System.Text;
还可以给using指令加上两个修饰符：
- global，该修饰符与向项目中每个源文件添加相同的using指令具有相同的效果。该修饰符是在C# 10中引入的。
- static，该修饰符从单个类型导入静态成员和嵌套类型，而不是导入所有类型。它是C#6.0中引入的。
你可以结合使用这两个修饰符，来达到从项目所有源文件中的类型中导入静态成员的目的。
你还可以使用using alias directive（别名指令）为命名空间或类型创建别名。
// using alias = namespace
using Project = PC.MyCompany.Project;
它也可以结合global来使用。
不带global修饰符的using指令的作用域是它所在的文件。using指令可以出现在以下位置：
- 源码文件的开头，在任何命名空间或类型声明之前。（一般文件中开头一大堆using就是这么用的）
- 在任意的命名空间中（即空间中套空间），但必须在该命名空间中声明任何命名空间或类型之前（空间中的开头部分），除非使用了global修饰符，在这种情况下，指令必须出现在所有命名空间和类型声明之前。
否则，会报编译错误CS1529。
建一个using指令来使用命名空间中的类型时，不必指定命名空间。
using指令不能访问嵌套在指定的命名空间中的任何命名空间。
比如 using x;只能访问x中直接包含的内容，
namespace x 中有 namespace y，那y命名空间中的东西就访问不了了。
需要你using x.y。
命名空间分两类：用户定义的和系统定义的。
用户定义的命名空间是在你的代码中定义的。系统定义的命名空间有许多，请参考.NET API Browser.
1.1. global修饰符
向using指令添加global修饰符表示将using应用于编译的所有文件（通常是整个项目）。
它的使用语法：
// fully-qualified-namespace可以理解为命名空间的全名
global using <fully-qualified-namespace>;
一个global using指令可以出现在任意源码文件的开头位置。在单个文件中的所有global using指令必须出现以下部分之前：
- 所有没有global修饰符的using指令
- 文件中所有命名空间和类型声明
一般在使用的时候，往往会将它们放在一个地方。global using指令的顺序并不重要。
global修饰符可以与static修饰符组合使用。global修饰符可以应用于using alias 指令。在这两种情况下，指令的作用域都是当前编译的所有文件。下面示例使用了System.Math中声明的所有方法：
global using static System.Math;
还可以通过添加<using>项，例如使用<Using Include=“My.Awesome.Namespace” />来包含一个命名空间。
1.2. static修饰符
using static指令一个类型，该类型的static成员和嵌套类型无需指定类型名即可访问。
该指令在C# 6中引入，它的语法如下：
using static 全名;
using static指令适用于任何具有static成员（或嵌套类型）的类型，即使它也具有实例成员。不过，它的实例成员只能由类型实例来调用。
你可以访问某个类型的静态成员，而不需要指定类型名来访问。
using static System.Console;
using static System.Math;
class Program
{
static void Main()
{
WriteLine(Sqrt(3*3 + 4*4));
}
}
通常，在调用静态成员时，需要提供类型名和成员名。重复输入相同的类型名来调用该类型的成员会导致冗长、晦涩的代码。例如，下面的Circle类定义引用Math类的成员：
using System;
public class Circle
{
public Circle(double radius)
{
Radius = radius;
}
public double Radius { get; set; }
public double Diameter
{
get { return 2 * Radius; }
}
public double Circumference
{
get { return 2 * Radius * Math.PI; }
}
public double Area
{
get { return Math.PI * Math.Pow(Radius, 2); }
}
}
通过消除每次引用成员时显式引用Math类，using static指令产生更精简、清晰的代码：
using System;
using static System.Math;
public class Circle
{
public Circle(double radius)
{
Radius = radius;
}
public double Radius { get; set; }
public double Diameter
{
get { return 2 * Radius; }
}
public double Circumference
{
get { return 2 * Radius * PI; }
}
public double Area
{
get { return PI * Pow(Radius, 2); }
}
}
using static导入时，只能访问指定类型中静态成员和嵌套类型。继承的成员不导入。你可以用 using static指令从任何的命名类型导入，包括VB模块。如果F#顶级函数以指定类型的静态成员的形式出现在元数据中，该类型的名称是有效的C#标识符，那么F#函数也能被导入。
using static使在指定类型中声明的扩展方法可用于扩展方法查找。但是，扩展方法的名称不会被导入到代码中非限定引用范围中。
从不同的类型中导入相同名称的方法，这些类型在同一编译单元或命名空间中使用不同的using static指令导入的，形成一个方法组（这tm原句妥妥的考研英语长难句，定语好几个，翻译出来贼拗口，反正就是指不同命名空间中方法重名的情况）。这些方法组中的重载解析遵循正常的C#规则。
下列示例使用using static指令使Console、Math和String类的静态成员可用，而无需指定它们的类型名称：
using System;
using static System.Console;
using static System.Math;
using static System.String;
class Program
{
static void Main()
{
Write("Enter a circle's radius: ");
var input = ReadLine();
if (!IsNullOrEmpty(input) && double.TryParse(input, out var radius)) {
var c = new Circle(radius);
string s = "\nInformation about the circle:\n";
s = s + Format(" Radius: {0:N2}\n", c.Radius);
s = s + Format(" Diameter: {0:N2}\n", c.Diameter);
s = s + Format(" Circumference: {0:N2}\n", c.Circumference);
s = s + Format(" Area: {0:N2}\n", c.Area);
WriteLine(s);
}
else {
WriteLine("Invalid input...");
}
}
}
public class Circle
{
public Circle(double radius)
{
Radius = radius;
}
public double Radius { get; set; }
public double Diameter
{
get { return 2 * Radius; }
}
public double Circumference
{
get { return 2 * Radius * PI; }
}
public double Area
{
get { return PI * Pow(Radius, 2); }
}
}
// The example displays the following output:
// Enter a circle's radius: 12.45
//
// Information about the circle:
// Radius: 12.45
// Diameter: 24.90
// Circumference: 78.23
// Area: 486.95
在本例中，using static指令也可以用于Double类型。添加该指令后，可以使得调用TryParse(String, Double)方法而不需要指定类型名。但是，使用不带类型名的TryParse会导致代码的可读性变差，因为需要检查using static指令以确定调用了哪个数字类型的TryParse方法。
using static也可以应用于enum类型（枚举类型）。通过对enum添加using static引用，该枚举类型不再需要使用enum成员的方式。
using static Color;
enum Color
{
Red,
Green,
Blue
}
class Program
{
public static void Main()
{
Color color = Green;
}
}
△1.3. 使用别名
创建using 别名指令，来使标识符更易被识别（用你自己熟悉的名称）。在任何using指令中，必须使用完全限定的名称空间或类型，无论在它之前有哪些using指令。无法在using指令的声明中使用using别名。例如，以下示例会产生一个编译错误：
using s = System.Text;
using s.RegularExpressions; // Generates a compiler error.
以下示例展示了如何为一个命名空间定义并使用一个using别名：
namespace PC
{
// Define an alias for the nested namespace.
using Project = PC.MyCompany.Project;
class A
{
void M()
{
// Use the alias
var mc = new Project.MyClass();
}
}
namespace MyCompany
{
namespace Project
{
public class MyClass { }
}
}
}
using别名指令不能在其右侧有开放的泛型类型（就是未明确定义类型的）。例如，你无法为List<T>创建别名，但你可以为List<int>创建别名。
以下示例展示了如何为一个类定义一个using指令和一个using别名：
using System;
// Using alias directive for a class.
using AliasToMyClass = NameSpace1.MyClass;
// Using alias directive for a generic class.
using UsingAlias = NameSpace2.MyClass<int>;
namespace NameSpace1
{
public class MyClass
{
public override string ToString()
{
return "You are in NameSpace1.MyClass.";
}
}
}
namespace NameSpace2
{
class MyClass<T>
{
public override string ToString()
{
return "You are in NameSpace2.MyClass.";
}
}
}
namespace NameSpace3
{
class MainClass
{
static void Main()
{
var instance1 = new AliasToMyClass();
Console.WriteLine(instance1);
var instance2 = new UsingAlias();
Console.WriteLine(instance2);
}
}
}
// Output:
// You are in NameSpace1.MyClass.
// You are in NameSpace2.MyClass.
△1.4. 如何使用VB My命名空间
略
VB部分我大概是不会用到的。
2. using语句
提供了便捷的语法来确保正确使用IDisposable对象。从C# 8.0开始，using语句还保证IAsyncDisposable对象的正确使用。
？？？
我相信初学者看到这一脸懵逼，IDisposable是啥？IAsyncDisposable又是啥？
跟using语句有啥关系啊？
我看到这也是这种感觉，mdzz
但微软文档介绍using语句的时候，就是这么写的，没办法，只能先将IDisposable简单学习下。
2.1. IDisposable接口
IDisposable从命名来看就是个接口。
Disposable：可任意使用的、一次性的、用完即丢弃的。
该接口的定义是，提供了一种释放非托管资源的机制。
IDisposable的文档部分非常直白地介绍了该接口的用途：
此接口的主要用途是释放非托管资源。
当管理的对象不再使用时，GC（.NET平台的垃圾回收器）会自动释放分配给该对象的内存。但是呢，到底何时回收垃圾是无法被预测的。而且，GC也不了解非托管资源，如窗口句柄、或打开的文件和流。
使用此接口的Dispose方法可以用GC显式地释放非托管的资源。当某个对象不再被需要时，对象的使用者可以调用此方法。
那么使用实现了IDisposable接口的对象通常有两种方式，
其中一种就是使用一种语言结构，如C#和VB中的using语句，以及F#中的use语句或using函数。当环境支持该语言结构时，你可以使用它来代替显式地调用IDisposable.Dispose。
重点看一下C#中的using语句，下面示例用这种方法定义了一个WordCount类，它保留了关于文件和单词数量的信息：
using System;
using System.IO;
using System.Text.RegularExpressions;
public class WordCount
{
private String filename = String.Empty;
private int nWords = 0;
private String pattern = @"\b\w+\b";
public WordCount(string filename)
{
if (!File.Exists(filename))
throw new FileNotFoundException("The file does not exist.");
this.filename = filename;
string txt = String.Empty;
using (StreamReader sr = new StreamReader(filename))
{
txt = sr.ReadToEnd();
}
nWords = Regex.Matches(txt, pattern).Count;
}
public string FullName
{ get { return filename; } }
public string Name
{ get { return Path.GetFileName(filename); } }
public int Count
{ get { return nWords; } }
}
using语句实际上是一种语法上的便利（语法糖？）。在编译时，语言编译器为try/finally块实现了中间语言（IL）。
好，现在IDisposable部分到此打住了，可以大致知道using语句其实是隐式地用了IDisposable.Dispose。对不用的对象进行了清理（新手理解到这层应该可以了）。
2.2. 示例
现在，回过来看using语句的示例：
string manyLines = @"This is line one
This is line two
Here is line three
The penultimate line is line four
This is the final, fifth line.";
using (var reader = new StringReader(manyLines))
{
string? item;
do
{
item = reader.ReadLine();
Console.WriteLine(item);
} while (item != null);
}
在C# 8.0引入的using声明是不需要大括号的（我个人觉得还是加了大括号可读性强一点，作用域给标注了嘛）：
string manyLines = @"This is line one
This is line two
Here is line three
The penultimate line is line four
This is the final, fifth line.";
using var reader = new StringReader(manyLines);
string? item;
do
{
item = reader.ReadLine();
Console.WriteLine(item);
} while (item != null);
2.3. 附注
File和Font是访问非托管资源（这里指的是文件句柄和设备上下文）的托管类型的例子。还有许多其他类型的非托管资源和封装它们的类库类型。所有这些类型都必须实现IDisposable接口，或者IAyncDisposable接口。
当IDisposable对象的生命周期被限制在单个方法时，你应该在using语句或using声明中声明并实例化它。这句话我觉得就是using语句使用的精髓了，就是using中把你需要限制生命周期的对象给加进去，那么在你大括号框的那段区域就是它的活动空间，超出区域就被回收了。using声明在对象超出作用域时，以正确的方式调用对象的Dispose方法。一旦调用Dispose，using语句就会造成对象本身超出作用域。在using块中，该对象是只读的，不能修改或重新分配。使用using声明声明的变量是只读的。如果对象实现了IAsyncDisposable接口而不是IDisposable，则using 结构调用DisposeAsync并等待返回的ValueTask。
两种using结构都会保证即使在using块中发生异常也会调用Dispose（或DisposeAsync）。你可以通过将对象放在try块中，然后在finally块中调用Dispose（或DisposeAsync）来实现相同的效果。实际上，编译器就是这样转换using语句和using声明的。上面的代码示例在编译时会展开为以下代码（注意，额外的花括号为对象创建限制范围）：
string manyLines = @"This is line one
This is line two
Here is line three
The penultimate line is line four
This is the final, fifth line.";
{
var reader = new StringReader(manyLines);
try
{
string? item;
do
{
item = reader.ReadLine();
Console.WriteLine(item);
} while (item != null);
}
finally
{
reader?.Dispose();
}
}
较新的using语句语法转变成了类似的写法。try块在声明变量的地方打开。finally块添加在封闭块的末尾，通常是方法的末尾。
一个类型的多个实例也可以在一个using语句中声明，如下示例所示。要注意的是，当你在一条语句中声明多个变量时，你不能使用隐式类型变量（var）：
string numbers = @"One
Two
Three
Four.";
string letters = @"A
B
C
D.";
using (StringReader left = new StringReader(numbers),
right = new StringReader(letters))
{
string? item;
do
{
item = left.ReadLine();
Console.Write(item);
Console.Write(" ");
item = right.ReadLine();
Console.WriteLine(item);
} while (item != null);
}
你也可以使用C# 8中引入的声明语法来组合相同类型的多个声明，如下所示：
string numbers = @"One
Two
Three
Four.";
string letters = @"A
B
C
D.";
using StringReader left = new StringReader(numbers),
right = new StringReader(letters);
string? item;
do
{
item = left.ReadLine();
Console.Write(item);
Console.Write(" ");
item = right.ReadLine();
Console.WriteLine(item);
} while (item != null);
你可以实例化资源对象，然后将变量传给using语句，但这不是最好的使用方式。该情况下，在控制离开using块之后，对象仍然在范围内，但可能无法访问其非托管资源。换句话说，它没有完全初始化。如果你试图在using块外使用对象，就有引发异常的风险。因为这个原因，最好在using语句中实例化对象，并将其作用域限制在using块。
string manyLines = @"This is line one
This is line two
Here is line three
The penultimate line is line four
This is the final, fifth line.";
var reader = new StringReader(manyLines);
using (reader)
{
string? item;
do
{
item = reader.ReadLine();
Console.WriteLine(item);
} while (item != null);
}
// reader is in scope here, but has been disposed
三、总结
C#中的using有两种用法，
- using指令用于引入命名空间。
- using语句用于便捷地使用实现了IDisposable接口的对象，使之生命周期限制在指定的作用域内。
