源代码下载： LearnCSharp-cn.cs
C#是一种优雅且类型安全的面向对象的语言，使开发人员能够构建运行在跨平台的.NET框架上，安全且健壮的应用程序。
// 单行注释以 // 开始
/*
多行注释是这样的
*/
/// <summary>
/// 这是 XML文档注释
/// 可用于生成外部文档或在 IDE 中提供上下文帮助
/// </summary>
/// <param name="firstParam">这是 firstParam 参数的文档</param>
/// <returns>这是函数返回值的信息</returns>
public void MethodOrClassOrOtherWithParsableHelp(string firstParam) { }
// 声明这段源码使用到的命名空间
// 下面的命名空间都是标准 .NET Framework 类库的一部分
using System;
using System.Collections.Generic;
using System.Dynamic;
using System.Linq;
using System.Net;
using System.Threading.Tasks;
using System.IO;
// 但是这个并不是标准类库:
using System.Data.Entity;
// 为了在下方使用它，你需要添加一个 dll 引用
// 你可以使用 NuGet 包管理器进行安装
// `Install-Package EntityFramework`
// 命名空间 Namespaces 可用于将一定的代码组织为 “包” 或者 “模块”
// 你可以在其他文件中这样引用：using Learning.CSharp;
// 在 C# 10 以后，你也可以这样定义命名空间。这被称为 file-scoped namespaces（文件范围的命名空间）.
// namespace Learning.CSharp;
namespace Learning
{
// 每个 .cs 文件至少需要包含一个和文件名相同的类
// 你可以不这么干，但是这样并不推荐。
public class LearnCSharp
{
// 基本语法 - 如果你以前用过 Java 或 C++ 的话，可以直接跳到后文「有趣的特性」
public static void Syntax()
{
// 使用 Console.WriteLine 打印信息
Console.WriteLine("Hello World");
Console.WriteLine(
"Integer: " + 10 +
" Double: " + 3.14 +
" Boolean: " + true);
// 使用 Console.Write 打印将不会换行
Console.Write("Hello ");
Console.Write("World");
///////////////////////////////////////////////////
// 类型和变量
//
// 使用 <type> <name> 定义变量
///////////////////////////////////////////////////
// Sbyte - 有符号 8-bit 整数
// (-128 <= sbyte <= 127)
sbyte fooSbyte = 100;
// Byte - 无符号 8-bit 整数
// (0 <= byte <= 255)
byte fooByte = 100;
// Short - 16-bit 整数
// 有符号 - (-32,768 <= short <= 32,767)
// 无符号 - (0 <= ushort <= 65,535)
short fooShort = 10000;
ushort fooUshort = 10000;
// Integer - 32-bit 整数
int fooInt = 1; // (-2,147,483,648 <= int <= 2,147,483,647)
uint fooUint = 1; // (0 <= uint <= 4,294,967,295)
// Long - 64-bit 整数
long fooLong = 100000L; // (-9,223,372,036,854,775,808 <= long <= 9,223,372,036,854,775,807)
ulong fooUlong = 100000L; // (0 <= ulong <= 18,446,744,073,709,551,615)
// 数字默认为 int 或 uint （取决于尺寸）
// 使用 L 标明变量值类型为long 或 ulong
// Double - 双精度 64-bit IEEE 754 浮点数
double fooDouble = 123.4; // 精度: 15-16 位
// Float - 单精度 32-bit IEEE 754 浮点数
float fooFloat = 234.5f; // 精度: 7 位
// 使用 f 标明变量值类型为float
// Decimal - 128-bits 数据类型，比其他浮点类型精度更高
// 适合财务、金融
decimal fooDecimal = 150.3m;
// 布尔值 - true & false
bool fooBoolean = true; // 或 false
// Char - 单个 16-bit Unicode 字符
char fooChar = 'A';
// 字符串 -- 和前面的基本类型不同，字符串不是值，而是引用。
// 这意味着你可以将字符串设为null。
string fooString = "\"escape\" quotes and add \n (new lines) and \t (tabs)";
Console.WriteLine(fooString);
// 你可以通过索引访问字符串的每个字符：
char charFromString = fooString[1]; // => 'e'
// 字符串不可修改: fooString[1] = 'X' 是行不通的;
// 根据当前的区域格式设置比较字符串，大小写不敏感
string.Compare(fooString, "x", StringComparison.CurrentCultureIgnoreCase);
// 基于sprintf的字符串格式化
string fooFs = string.Format("Check Check, {0} {1}, {0} {1:0.0}", 1, 2);
// 日期和格式
DateTime fooDate = DateTime.Now;
Console.WriteLine(fooDate.ToString("hh:mm, dd MMM yyyy"));
// 逐字字符串
// 使用 @ 符号可以创建跨行的字符串。使用 "" 来表示 "
string bazString = @"Here's some stuff
on a new line! ""Wow!"", the masses cried";
// 使用 const 或 read-only 定义常量
// 常量在编译阶段演算
const int HOURS_I_WORK_PER_WEEK = 9001;
///////////////////////////////////////////////////
// 数据结构
///////////////////////////////////////////////////
// 数组 - 从0开始计数
// 声明数组时需要指定数组长度
// 声明数组的格式如下：
// <datatype>[] <var name> = new <datatype>[<array size>];
int[] intArray = new int[10];
// 声明并初始化数组的其他方式：
int[] y = { 9000, 1000, 1337 };
// 访问数组的元素
Console.WriteLine("intArray @ 0: " + intArray[0]);
// 数组可以修改
intArray[1] = 1;
// 列表
// 列表比数组更常用，因为列表更灵活。
// 声明列表的格式如下：
// List<datatype> <var name> = new List<datatype>();
List<int> intList = new List<int>();
List<string> stringList = new List<string>();
List<int> z = new List<int> { 9000, 1000, 1337 }; // 初始化
// <> 用于泛型 - 参考下文
// 列表无默认值
// 访问列表元素时必须首先添加元素
intList.Add(1);
Console.WriteLine("intList @ 0: " + intList[0]);
// 其他数据结构：
// Stack 堆栈 / Queue 队列
// Dictionary 字典 (哈希表的实现)
// HashSet 哈希集合
// Read-only Collections 只读集合
// Tuple 元组 (.Net 4+)
///////////////////////////////////////
// 操作符
///////////////////////////////////////
Console.WriteLine("\n->Operators");
int i1 = 1, i2 = 2; // 声明多个变量的简写形式
// 算术直截了当
Console.WriteLine(i1 + i2 - i1 * 3 / 7); // => 3
// 取余
Console.WriteLine("11%3 = " + (11 % 3)); // => 2
// 比较操作符
Console.WriteLine("3 == 2? " + (3 == 2)); // => false
Console.WriteLine("3 != 2? " + (3 != 2)); // => true
Console.WriteLine("3 > 2? " + (3 > 2)); // => true
Console.WriteLine("3 < 2? " + (3 < 2)); // => false
Console.WriteLine("2 <= 2? " + (2 <= 2)); // => true
Console.WriteLine("2 >= 2? " + (2 >= 2)); // => true
// 位操作符
/*
~ 取反
<< 左移（有符号）
>> 右移（有符号）
& 与
^ 异或
| 或
*/
// 自增、自减
int i = 0;
Console.WriteLine("\n->Inc/Dec-rementation");
Console.WriteLine(i++); //i = 1. 事后自增
Console.WriteLine(++i); //i = 2. 事先自增
Console.WriteLine(i--); //i = 1. 事后自减
Console.WriteLine(--i); //i = 0. 事先自减
///////////////////////////////////////
// 控制结构
///////////////////////////////////////
Console.WriteLine("\n->Control Structures");
// 类似 C 的 if 语句
int j = 10;
if (j == 10)
{
Console.WriteLine("I get printed");
}
else if (j > 10)
{
Console.WriteLine("I don't");
}
else
{
Console.WriteLine("I also don't");
}
// 三元表达式
// 简单的 if/else 语句可以写成：
// <条件> ? <真> : <假>
int toCompare = 17;
string isTrue = toCompare == 17 ? "True" : "False";
// While 循环
int fooWhile = 0;
while (fooWhile < 100)
{
// 迭代 100 次, fooWhile 0->99
fooWhile++;
}
// Do While 循环
int fooDoWhile = 0;
do
{
// 迭代 100 次, fooDoWhile 0->99
if (false)
continue; // 跳过本次迭代
fooDoWhile++;
if (fooDoWhile == 50)
break; // 结束整个循环
} while (fooDoWhile < 100);
// for 循环结构 => for(<初始条件>; <条件>; <步>)
for (int fooFor = 0; fooFor < 10; fooFor++)
{
// 迭代10次, fooFor 0->9
}
// foreach循环
// foreach 循环结构 => foreach(<迭代器类型> <迭代器> in <可枚举结构>)
// foreach 循环适用于任何实现了 IEnumerable 或 IEnumerable<T> 的对象。
// .Net 框架下的集合类型(数组, 列表, 字典...)
// 都实现了这些接口
// (下面的代码中，ToCharArray()可以删除，因为字符串同样实现了IEnumerable)
foreach (char character in "Hello World".ToCharArray())
{
//迭代字符串中的所有字符
}
// Switch 语句
// switch 适用于 byte、short、char 和 int 数据类型。
// 同样适用于可枚举的类型
// 包括字符串类, 以及一些封装了原始值的类：
// Character、Byte、Short和Integer。
int month = 3;
string monthString;
switch (month)
{
case 1:
monthString = "January";
break;
case 2:
monthString = "February";
break;
case 3:
monthString = "March";
break;
// 你可以一次匹配多个case语句
// 但是你在添加case语句后需要使用break
// （否则你需要显式地使用goto case x语句）
case 6:
case 7:
case 8:
monthString = "Summer time!!";
break;
default:
monthString = "Some other month";
break;
}
///////////////////////////////////////
// 转换、指定数据类型
///////////////////////////////////////
// 转换类型
// 转换字符串为整数
// 转换失败会抛出异常
int.Parse("123"); // 返回整数类型的"123"
// TryParse 会尝试转换类型，失败时会返回缺省类型
// 例如 0
int tryInt;
if (int.TryParse("123", out tryInt)) // Funciton is boolean
Console.WriteLine(tryInt); // 123
// 转换整数为字符串
// Convert 类提供了一系列方便转换类型的方法
// 比如 字符串 与 int 之间
// 最佳方法
bool result = int.TryParse(string, out var integer)
int.Parse(string);
// 不推荐
Convert.ToString(123);
// Int 到字符串
tryInt.ToString();
// 转换
// 显式转换 decimal 类型的 15 为 int 类型
// 然后隐式转换为 long 类型
long x = (int) 15M;
}
///////////////////////////////////////
// 类 - 请参阅文件末尾的定义
///////////////////////////////////////
public static void Classes()
{
// 参看文件尾部的对象声明
// 使用 new 初始化对象
Bicycle trek = new Bicycle();
// 调用对象的方法
trek.SpeedUp(3); // 你应该一直使用 setter 和 getter 方法
trek.Cadence = 100;
// 查看对象的信息.
Console.WriteLine("trek info: " + trek.Info());
// 实例化一个新的 Penny Farthing 对象
PennyFarthing funbike = new PennyFarthing(1, 10);
Console.WriteLine("funbike info: " + funbike.Info());
Console.Read();
} // 结束main方法
// record 在 C# 9 及以后可用, 这基本上是类的语法糖. record 对象是不可变的 immutable*.
public record ARecord(string Csharp);
// 终端程序入口 终端程序必须有一个 main 方法作为入口
public static void Main(string[] args)
{
OtherInterestingFeatures();
}
//
// 有趣的特性
//
// 默认方法签名
public // 可见性
static // 允许从类直接调用，无需先创建实例
int // 返回值类型
MethodSignatures(
int maxCount, // 第一个参数，类型为整型
int count = 0, // 如果没有传入值，则缺省值为 0
int another = 3,
params string[] otherParams // 捕获其他参数
)
{
return -1;
}
// 方法可以重名，只要方法签名不一样
// 一个只有返回值类型不同的方法
public static void MethodSignatures(
ref int maxCount, // 通过引用传递
out int count)
{
// 通过 'count' 参数传入的值将在该方法外保留值 15
count = 15; // 必须在离开方法之前为 out 参数赋值
}
// 泛型
// TKey 和 TValue 由用户调用方法时指定
// 以下函数模拟了 Python 的 SetDefault
public static TValue SetDefault<TKey, TValue>(
IDictionary<TKey, TValue> dictionary,
TKey key,
TValue defaultItem)
{
TValue result;
if (!dictionary.TryGetValue(key, out result))
return dictionary[key] = defaultItem;
return result;
}
// 你可以限定传入值的范围
public static void IterateAndPrint<T>(T toPrint) where T: IEnumerable<int>
{
// 我们可以进行迭代，因为 T 是可枚举的
foreach (var item in toPrint)
// item 为整数
Console.WriteLine(item.ToString());
}
// YIELD
// 使用 "yield" 关键字表明它出现的方法是一个迭代器 Iterator
// (这意味着你可以在 foreach 循环中使用它)
public static IEnumerable<int> YieldCounter(int limit = 10)
{
for (var i = 0; i < limit; i++)
yield return i;
}
// 你可以这样调用它
public static void PrintYieldCounterToConsole()
{
foreach (var counter in YieldCounter())
Console.WriteLine(counter);
}
// 你可以在一个方法中使用多个 "yield return"
public static IEnumerable<int> ManyYieldCounter()
{
yield return 0;
yield return 1;
yield return 2;
yield return 3;
}
// 你也可以使用 "yield break" 停止该迭代器
// 此方法只会返回从 0 到 limit 的一半值。
public static IEnumerable<int> YieldCounterWithBreak(int limit = 10)
{
for (var i = 0; i < limit; i++)
{
if (i > limit / 2) yield break;
yield return i;
}
}
public static void OtherInterestingFeatures()
{
// 可选参数
MethodSignatures(3, 1, 3, "Some", "Extra", "Strings");
MethodSignatures(3, another: 3); // 显式指定参数，忽略可选参数
// 使用 ref 和 out 参数
int maxCount = 0, count; // ref 参数必须有值
MethodSignatures(ref maxCount, out count);
// 扩展方法
int i = 3;
i.Print(); // 参见下面的定义
// 可为 null 的类型 对数据库交互、返回值很有用
// 任何值类型 (i.e. 不为类) 添加后缀 ? 后会变为可为null的值
// <类型>? <变量名> = <值>
int? nullable = null; // Nullable<int> 的简写形式
Console.WriteLine("Nullable variable: " + nullable);
bool hasValue = nullable.HasValue; // 不为null时返回真
// ?? 是用于指定默认值的语法糖
// 以防变量为null的情况
int notNullable = nullable ?? 0; // 0
// ?. 是另一个可空类型的操作符 - 简写 null 检查
nullable?.Print(); // 当可空类型值不为 null 的时候调用 Print() 拓展方法
// 变量类型推断 - 你可以让编译器推断变量类型:
var magic = "编译器确定magic是一个字符串，所以仍然是类型安全的";
// magic = 9; // 不工作，因为magic是字符串，而不是整数。
// 泛型
//
var phonebook = new Dictionary<string, string>() {
{"Sarah", "212 555 5555"} // 在电话簿中加入新条目
};
// 调用上面定义为泛型的 SETDEFAULT
Console.WriteLine(SetDefault<string, string>(phonebook, "Shaun", "No Phone")); // No Phone
// 你不用指定 TKey、TValue 的类型
// 因为它们会被隐式地推导出来
Console.WriteLine(SetDefault(phonebook, "Sarah", "No Phone")); // 212 555 5555
// lambda表达式 - 允许你用一行代码搞定函数
Func<int, int> square = (x) => x * x; // 最后一项为返回值
Console.WriteLine(square(3)); // 9
// 错误处理 - 应对不确定的世界
try
{
var funBike = PennyFarthing.CreateWithGears(6);
// 将不再执行，因为 CreateWithGears 抛出异常
string some = "";
if (true) some = null;
some.ToLower(); // 抛出 NullReferenceException
}
catch (NotSupportedException)
{
Console.WriteLine("Not so much fun now!");
}
catch (Exception ex) // 捕获所有其他异常
{
throw new ApplicationException("It hit the fan", ex);
// throw; // 重新抛出异常并保留调用堆栈
}
// catch { } // 捕获所有没有捕获的异常
finally
{
// 在 try 或 catch 之后执行
}
// 可抛弃的资源管理 - 让你很容易地处理未托管的资源
// 大多数访问未托管资源 (文件句柄、设备上下文, etc.) 的对象
// 都实现了 IDisposable 接口。
// using语句会为你清理 IDisposable 对象
using (StreamWriter writer = new StreamWriter("log.txt"))
{
writer.WriteLine("这里没有什么可疑的东西");
// 在作用域的结尾，资源会被回收
// （即使有异常抛出，也一样会回收）
}
// 并行框架
// https://learn.microsoft.com/zh-cn/dotnet/standard/parallel-programming/data-parallelism-task-parallel-library
var words = new List<string> {"dog", "cat", "horse", "pony"};
Parallel.ForEach(words,
new ParallelOptions() { MaxDegreeOfParallelism = 4 },
word =>
{
Console.WriteLine(word);
}
);
// 运行它会产生不同的输出
// 因为每个线程在不同的时间完成
// 一些可能的输出是：
// cat dog horse pony
// dog horse pony cat
// 动态对象（配合其他语言使用很方便）
dynamic student = new ExpandoObject();
student.FirstName = "First Name"; // 不需要先定义类！
// 你甚至可以添加方法（接受一个字符串，输出一个字符串）
student.Introduce = new Func<string, string>(
(introduceTo) => string.Format("Hey {0}, this is {1}", student.FirstName, introduceTo));
Console.WriteLine(student.Introduce("Beth"));
// IQUERYABLE<T> - 几乎所有的集合都实现了它，
// 带给你 Map / Filter / Reduce 风格的方法
var bikes = new List<Bicycle>();
bikes.Sort(); // 排序 array
bikes.Sort((b1, b2) => b1.Wheels.CompareTo(b2.Wheels)); // 根据车轮数排序
var result = bikes
.Where(b => b.Wheels > 3) // 筛选 - 可以连锁使用 （返回 IQueryable)
.Where(b => b.IsBroken && b.HasTassles)
.Select(b => b.ToString()); // Map - 这里我们使用了select，所以结果是IQueryable<string>
var sum = bikes.Sum(b => b.Wheels); // Reduce - 计算集合中的轮子总数
// 创建一个包含基于自行车的一些参数生成的隐式对象的列表
var bikeSummaries = bikes.Select(b=>new { Name = b.Name, IsAwesome = !b.IsBroken && b.HasTassles });
// 很难演示，但是编译器在代码编译完成前就能推导出以上对象的类型
foreach (var bikeSummary in bikeSummaries.Where(b => b.IsAwesome))
Console.WriteLine(bikeSummary.Name);
// ASPARALLEL
// 这就是事情开始棘手的地方 —— 组合了 linq 和并行操作
var threeWheelers = bikes.AsParallel().Where(b => b.Wheels == 3).Select(b => b.Name);
// 以上代码会并发地运行。会自动新开线程，分别计算结果。
// 适用于多核、大数据量的场景。
// LINQ - 映射一组 IQueryable<T> 对象，并延迟执行
// 例如 LinqToSql 映射数据库, LinqToXml 映射XML文档
var db = new BikeRespository();
// 执行被延迟了，这对于查询数据库来说非常好
var filter = db.Bikes.Where(b => b.HasTassles); // 不运行查询
if (42 > 6) // 你可以不断地增加筛选，包括有条件的筛选，例如用于“高级搜索”功能
filter = filter.Where(b => b.IsBroken); // 不运行查询
var query = filter
.OrderBy(b => b.Wheels)
.ThenBy(b => b.Name)
.Select(b => b.Name); // 仍然不运行查询
// 现在运行查询，运行查询的时候会打开一个读取器，所以你迭代的是一个副本
foreach (string bike in query)
Console.WriteLine(result);
}
} // 结束LearnCSharp类
// 你可以在同一个 .cs 文件中包含其他类
public static class Extensions
{
// 扩展函数
public static void Print(this object obj)
{
Console.WriteLine(obj.ToString());
}
}
// 委托 和 事件
public class DelegateTest
{
public static int count = 0;
public static int Increment()
{
// 增加 count 然后返回它
return ++count;
}
// 委托是一个方法的引用.
// 要引用 Increment 方法,
// 首先声明一个具有相同签名的委托,
// i.e. 不带参数并返回 int
public delegate int IncrementDelegate();
// 事件也可用于触发委托
// 使用委托类型创建事件
public static event IncrementDelegate MyEvent;
static void Main(string[] args)
{
// 通过实例化委托来引用 Increment 方法
// 并将方法本身作为参数传递
IncrementDelegate inc = new IncrementDelegate(Increment);
Console.WriteLine(inc()); // => 1
// 委托可以用 + 运算符组合
IncrementDelegate composedInc = inc;
composedInc += inc;
composedInc += inc;
// composedInc 将执行 Increment 3 次
Console.WriteLine(composedInc()); // => 4
// 为事件订阅与委托
MyEvent += new IncrementDelegate(Increment);
MyEvent += new IncrementDelegate(Increment);
// 触发事件
// ie. 运行这个事件所有的委托订阅
Console.WriteLine(MyEvent()); // => 6
}
}
// 声明类的语法：
// <public/private/protected/internal> class <类名>{
// // 数据字段, 构造器, 内部函数
// // 在Java中函数被称为方法
// }
public class Bicycle
{
// 自行车的字段/变量
public int Cadence // Public: 任何地方都可以访问
{
get // get - 定义获取属性的方法
{
return _cadence;
}
set // set - 定义设置属性的方法
{
_cadence = value; // value 是被传递给 setter 的值
}
}
private int _cadence;
protected virtual int Gear // Protected: 类和子类可以访问
{
get; // 创建一个自动属性，无需成员字段
set;
}
internal int Wheels // Internal: 在同一程序集内可以访问
{
get;
private set; // 可以给 get/set 方法添加修饰符
}
int _speed; // 类中的任何内容默认为 private: 只可以在这个类内访问
// 你也可以使用 `private` 关键词显式指定
public string Name { get; set; }
// 当您想要一个仅返回表达式结果的只读属性时，
// 属性还具有特殊的语法
public string LongName => Name + " " + _speed + " speed";
// enum 枚举是一种值类型，由一组命名常量组成
// 它将名称映射到值（除非特别说明，是一个整型）
// enmu 元素的类型可以是 byte、sbyte、short、ushort、int、uint、long、ulong
// enum 不能包含相同的值
public enum BikeBrand
{
AIST,
BMC,
Electra = 42, //你可以显式地赋值
Gitane // 43
}
// 我们在 Bicycle 类中定义的这个类型，所以它是一个内嵌类型
// 这个类以外的代码应当使用 `Bicycle.Brand` 来引用
public BikeBrand Brand; // 声明一个 enum 类型之后，我们可以声明这个类型的字段
// 使用 FlagsAttribute 定义枚举，表示有多个值可以被匹配
// 任何从 Attribute 派生的类都可以用来修饰类型、方法、参数等
// 位运算符 & 和 | 可用于 和/或 操作
[Flags]
public enum BikeAccessories
{
None = 0,
Bell = 1,
MudGuards = 2, // 需要手动设定值!
Racks = 4,
Lights = 8,
FullPackage = Bell | MudGuards | Racks | Lights
}
// 用法: aBike.Accessories.HasFlag(Bicycle.BikeAccessories.Bell)
// 在 .NET 4 之前: (aBike.Accessories & Bicycle.BikeAccessories.Bell) == Bicycle.BikeAccessories.Bell
public BikeAccessories Accessories { get; set; }
// 静态方法属于类型自身，不属于特定的对象
// 你无需通过对象就可以访问他们
// Console.WriteLine("Bicycles created: " + Bicycle.bicyclesCreated);
static public int BicyclesCreated = 0;
// 只读值在运行时确定
// 它们只能在声明或构造器内被赋值
readonly bool _hasCardsInSpokes = false; // read-only private
// 构造器是创建类的一种方式
// 下面是一个默认的构造器
public Bicycle()
{
this.Gear = 1; // 你可以使用关键词 this 访问对象的成员
Cadence = 50; // 不过你并不总是需要它
_speed = 5;
Name = "Bontrager";
Brand = BikeBrand.AIST;
BicyclesCreated++;
}
// 另一个构造器的例子（包含参数）
public Bicycle(int startCadence, int startSpeed, int startGear,
string name, bool hasCardsInSpokes, BikeBrand brand)
: base() // 显式调用基类的无参构造方法
{
Gear = startGear;
Cadence = startCadence;
_speed = startSpeed;
Name = name;
_hasCardsInSpokes = hasCardsInSpokes;
Brand = brand;
}
// 构造器可以连锁使用
public Bicycle(int startCadence, int startSpeed, BikeBrand brand) :
this(startCadence, startSpeed, 0, "big wheels", true, brand)
{
}
// 函数语法
// <public/private/protected> <返回值> <函数名称>(<参数>)
// 类可以为其字段实现 getters 和 setters 方法
// 或者可以使用属性封装字段（C#推荐使用这个）
// 方法的参数可以有默认值
// 在有默认值的情况下，调用方法的时候可以省略相应的参数
public void SpeedUp(int increment = 1)
{
_speed += increment;
}
public void SlowDown(int decrement = 1)
{
_speed -= decrement;
}
// 属性可以访问和设置值
// 当只需要外部访问数据的时候，考虑使用属性。
// 属性可以定义 get 和 set，或者是同时定义两者
private bool _hasTassles; // private variable
public bool HasTassles // public accessor
{
get { return _hasTassles; }
set { _hasTassles = value; }
}
// 你可以在一行之内定义自动属性
// 这个语法会自动创建后备字段
// 你可以给 getter 或 setter 设置访问修饰符
// 以便限制它们的访问
public bool IsBroken { get; private set; }
// 属性的实现可以是自动的
public int FrameSize
{
get;
// 你可以给 get 或 set 指定访问修饰符
// 以下代码意味着只有 Bicycle 类可以调用 Framesize 的 set
private set;
}
// 还可以在对象上定义自定义索引器
// 尽管这在本例中并不完全有用, you
// 你可以使用 bicycle[0] 返回 "chris" 来获得第一项
// 或者 bicycle[1] = "lisa" 来设定值
private string[] passengers = { "chris", "phil", "darren", "regina" };
public string this[int i]
{
get {
return passengers[i];
}
set {
passengers[i] = value;
}
}
// 显示对象属性的方法
public virtual string Info()
{
return "Gear: " + Gear +
" Cadence: " + Cadence +
" Speed: " + _speed +
" Name: " + Name +
" Cards in Spokes: " + (_hasCardsInSpokes ? "yes" : "no") +
"\n------------------------------\n"
;
}
// 方法可以是静态的。通常用于辅助方法。
public static bool DidWeCreateEnoughBycles()
{
// 在静态方法中，你只能引用类的静态成员
return BicyclesCreated > 9000;
} // 如果你的类只需要静态成员，考虑将整个类作为静态类。
} // Bicycle类结束
// PennyFarthing 是 Bicycle 的一个子类
class PennyFarthing : Bicycle
{
// (Penny Farthings是一种前轮很大的自行车。没有齿轮。）
// 调用父构造器
public PennyFarthing(int startCadence, int startSpeed) :
base(startCadence, startSpeed, 0, "PennyFarthing", true, BikeBrand.Electra)
{
}
protected override int Gear
{
get
{
return 0;
}
set
{
throw new ArgumentException("你不可能在 PennyFarthing 上切换齿轮");
}
}
public static PennyFarthing CreateWithGears(int gears)
{
var penny = new PennyFarthing(1, 1);
penny.Gear = gears; // 你不能这样做!
return penny;
}
public override string Info()
{
string result = "PennyFarthing bicycle ";
result += base.ToString(); // 调用父方法
return result;
}
}
// 接口只包含成员的签名，而没有实现。
interface IJumpable
{
void Jump(int meters); // 所有接口成员是隐式地公开的 public
}
interface IBreakable
{
bool Broken { get; } // 接口可以包含属性、方法和事件
}
// 类只能继承一个类，但是可以实现任意数量的接口
// 但是基类名称必须是列表中的第一个，所有接口都在后面
class MountainBike : Bicycle, IJumpable, IBreakable
{
int damage = 0;
public void Jump(int meters)
{
damage += meters;
}
public bool Broken
{
get
{
return damage > 100;
}
}
}
/// <summary>
/// 连接数据库，一个 LinqToSql 的示例。
/// EntityFramework Code First 很棒 (类似 Ruby的 ActiveRecord, 不过是双向的)
/// https://learn.microsoft.com/zh-cn/ef/ef6/modeling/code-first/workflows/new-database
/// </summary>
public class BikeRepository : DbContext
{
public BikeRepository()
: base()
{
}
public DbSet<Bicycle> Bikes { get; set; }
}
// 一个类可以通过 partial 关键字分别写在多个 .cs 文件中
// A1.cs
public partial class A
{
public static void A1()
{
Console.WriteLine("Method A1 in class A");
}
}
// A2.cs
public partial class A
{
public static void A2()
{
Console.WriteLine("Method A2 in class A");
}
}
// 使用 partial 类 "A"
public class Program
{
static void Main()
{
A.A1();
A.A2();
}
}
// 通过在字符串前加上 $ 前缀来进行字符串插值
// 并用 { 大括号 } 包裹要插值的表达式
// 您还可以将插值字符串和逐字字符串与 $@ 组合起来
public class Rectangle
{
public int Length { get; set; }
public int Width { get; set; }
}
class Program
{
static void Main(string[] args)
{
Rectangle rect = new Rectangle { Length = 5, Width = 3 };
Console.WriteLine($"The length is {rect.Length} and the width is {rect.Width}");
string username = "User";
Console.WriteLine($@"C:\Users\{username}\Desktop");
}
}
// C# 6 新特性
class GlassBall : IJumpable, IBreakable
{
// 自动属性设置初始值
public int Damage { get; private set; } = 0;
// 为仅有 getter 的自动属性设定初始值
public string Name { get; } = "Glass ball";
// 在构造函数中初始化的仅有 getter 的自动属性
public string GenieName { get; }
public GlassBall(string genieName = null)
{
GenieName = genieName;
}
public void Jump(int meters)
{
if (meters < 0)
// 新的 nameof() 表达式; 编译器将检查标识符是否存在
// nameof(x) == "x"
// 预防 例如 参数名称已更改但错误消息中未更新
throw new ArgumentException("Cannot jump negative amount!", nameof(meters));
Damage += meters;
}
// 表达式主体 expression-bodied 属性 ...
public bool Broken
=> Damage > 100;
// ... 刚发
public override string ToString()
// 插值字符串
=> $"{Name}. Damage taken: {Damage}";
public string SummonGenie()
// Null 条件运算符
// x?.y 如果 x 为 null 将立即返回 null; y 将不会求值
=> GenieName?.ToUpper();
}
static class MagicService
{
private static bool LogException(Exception ex)
{
// 记录某处的异常
return false;
}
public static bool CastSpell(string spell)
{
try
{
// 假设我们在这里调用 API
throw new MagicServiceException("Spell failed", 42);
// Spell succeeded
return true;
}
// 仅当 Code 为 42（Spell failed）时才捕获
catch(MagicServiceException ex) when (ex.Code == 42)
{
// Spell failed
return false;
}
// 其他异常，或 MagicServiceException 的 Code 不是 42
catch(Exception ex) when (LogException(ex))
{
// 永远不会执行到这块代码
// 堆栈未展开
}
return false;
// 请注意，捕获 MagicServiceException
// 并在 Code 不是 42 或 117 时重新抛出是不同的
// 因为最终的 catch-all 块将不会捕获重新抛出的异常
}
}
public class MagicServiceException : Exception
{
public int Code { get; }
public MagicServiceException(string message, int code) : base(message)
{
Code = code;
}
}
public static class PragmaWarning {
// 过时的属性
[Obsolete("Use NewMethod instead", false)]
public static void ObsoleteMethod()
{
// obsolete code
}
public static void NewMethod()
{
// new code
}
public static void Main()
{
ObsoleteMethod(); // CS0618: 'ObsoleteMethod 已过时：使用 NewMethod 代替'
#pragma warning disable CS0618
ObsoleteMethod(); // no warning
#pragma warning restore CS0618
ObsoleteMethod(); // CS0618: 'ObsoleteMethod 已过时：使用 NewMethod 代替'
}
}
} // 结束 Namespace
using System;
// C# 6, 静态引用
using static System.Math;
namespace Learning.More.CSharp
{
class StaticUsing
{
static void Main()
{
// 不使用静态引用时..
Console.WriteLine("The square root of 4 is {}.", Math.Sqrt(4));
// 使用时
Console.WriteLine("The square root of 4 is {}.", Sqrt(4));
}
}
}
// C# 7 新特性
// 使用 Nuget 安装 Microsoft.Net.Compilers 最新版
// 使用 Nuget 安装 System.ValueTuple 最新版
using System;
namespace Csharp7
{
// 元组 TUPLES, 析构 DECONSTRUCTION 和 弃元 DISCARDS
class TuplesTest
{
public (string, string) GetName()
{
// 元组中的字段默认命名为 Item1、Item2...
var names1 = ("Peter", "Parker");
Console.WriteLine(names1.Item2); // => Parker
// 字段可以显式命名
// 第 1 种声明
(string FirstName, string LastName) names2 = ("Peter", "Parker");
// 第 2 种声明
var names3 = (First:"Peter", Last:"Parker");
Console.WriteLine(names2.FirstName); // => Peter
Console.WriteLine(names3.Last); // => Parker
return names3;
}
public string GetLastName() {
var fullName = GetName();
// 元组可以被析构
(string firstName, string lastName) = fullName;
// 析构获得的字段可以使用 弃元 _ 丢弃
var (_, last) = fullName;
return last;
}
// 通过指定析构方法，
// 可以以相同的方式解构任何类型
public int randomNumber = 4;
public int anotherRandomNumber = 10;
public void Deconstruct(out int randomNumber, out int anotherRandomNumber)
{
randomNumber = this.randomNumber;
anotherRandomNumber = this.anotherRandomNumber;
}
static void Main(string[] args)
{
var tt = new TuplesTest();
(int num1, int num2) = tt;
Console.WriteLine($"num1: {num1}, num2: {num2}"); // => num1: 4, num2: 10
Console.WriteLine(tt.GetLastName());
}
}
// 模式匹配
class PatternMatchingTest
{
public static (string, int)? CreateLogMessage(object data)
{
switch(data)
{
// 使用 when 进行附加过滤
case System.Net.Http.HttpRequestException h when h.Message.Contains("404"):
return (h.Message, 404);
case System.Net.Http.HttpRequestException h when h.Message.Contains("400"):
return (h.Message, 400);
case Exception e:
return (e.Message, 500);
case string s:
return (s, s.Contains("Error") ? 500 : 200);
case null:
return null;
default:
return (data.ToString(), 500);
}
}
}
// Reference 变量 / ref 局部变量
// 允许返回对象的引用而不仅仅是其值
class RefLocalsTest
{
// 返回值前标明 ref
public static ref string FindItem(string[] arr, string el)
{
for(int i=0; i<arr.Length; i++)
{
if(arr[i] == el) {
// 返回引用
return ref arr[i];
}
}
throw new Exception("Item not found");
}
public static void SomeMethod()
{
string[] arr = {"this", "is", "an", "array"};
// 要在所有地方使用 ref
ref string item = ref FindItem(arr, "array");
item = "apple";
Console.WriteLine(arr[3]); // => apple
}
}
// 本地函数 LOCAL FUNCTIONS
class LocalFunctionTest
{
private static int _id = 0;
public int id;
public LocalFunctionTest()
{
id = generateId();
// 这个本地函数只能在此作用域中被访问
int generateId()
{
return _id++;
}
}
public static void AnotherMethod()
{
var lf1 = new LocalFunctionTest();
var lf2 = new LocalFunctionTest();
Console.WriteLine($"{lf1.id}, {lf2.id}"); // => 0, 1
int id = generateId();
// error CS0103: 当前上下文中不存在名称“generateId”
}
}
}
✨ 新的, 👍 旧的, 🎈 长期支持的, 🔥 跨平台的, 🎁 只支持Windows的
特性 Attributes
异步编程
Web 开发
桌面应用开发 Development
跨平台开发
有建议？或者发现什么错误？在GitHub上开一个issue，或者发起pull request！
原著Irfan Charania，并由11个好心人修改。