[TOC]本文内容来自我写的开源电子书《WoW C#》，现在正在编写中，可以去WOW-Csharp/学习路径总结.md at master · sogeisetsu/WOW-Csharp (github.com)来查看编写进度。预计2021年年底会完成编写，2022年2月之前会完成所有的校对和转制电子书工作，争取能够在2022年将此书上架亚马逊。编写此书的目的是因为目前.NET市场相对低迷，很多优秀的书都是基于.NET framework框架编写的，与现在的.NET 6相差太大，正规的.NET 5学习教程现在几乎只有MSDN，可是MSDN虽然准确优美但是太过琐碎，没有过阅读开发文档的同学容易一头雾水，于是，我就编写了基于.NET 5的《WoW C#》。本人水平有限，欢迎大家去本书的开源仓库sogeisetsu/WOW-Csharp关注、批评、建议和指导。

数组与集合的概念

数组是一种指定长度和数据类型的对象，在实际应用中有一定的局限性。

集合正是为这种局限性而生的，集合的长度能根据需要更改，也允许存放任何数据类型的值。

Array

,

ArrayList

and

List<T>

Array、ArrayList和List都是从IList派生出来的，它们都实现了IEnumerable接口

从某种意义上来说，ArrayList和List属于集合的范畴，因为他们都来自程序集

System.Collections

，但是因为它们都是储存了多个变量的数据结构，并且都不是类似键值对的组合，并且没有先进先出或者先进后出的机制，故而称为数组。

我们一般称呼

Array

,

ArrayList

and

List<T>

为数组。

Array

**Array必须在定义且不初始化赋值的时候（不初始化的情况下声明数组变量除外）必须定义数组最外侧的长度。**比如：

int[] vs = new int[10];int[,] duoWei = new int[3, 4];int[][] jiaoCuo = new int[3][]; // 该数组是由三个一维数组组成的

一维数组

定义

用类似于这种方式定义一个数组

int[] array = new int[5];

初始化赋值

用类似于这种方式初始化

int[] array1 = new int[] { 1, 3, 5, 7, 9 };

也可以进行隐式初始化

int[] array2 = { 1, 3, 5, 7, 9 };string[] weekDays2 = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" };

用类似于下面这种方式先声明，再赋值

int[] array3;array3 = new int[] { 1, 3, 5, 7, 9 };   // OK//array3 = {1, 3, 5, 7, 9};   // Error

多维数组

数组可具有多个维度。多维数组的每个元素是声明时的数组所属类型的元素。比如说

int[,]

的每个元素都是int类型而不是int[]类型。换种说法就是多维数组不能算做“数组组成的数组”。

定义

用类似下面这种方式声明一个二维数组的长度

int[,] array = new int[4, 2];

初始化赋值

用类似于下面的方式初始化多维数组：

// Two-dimensional array.int[,] array2D = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };// The same array with dimensions specified.int[,] array2Da = new int[4, 2] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };// A similar array with string elements.string[,] array2Db = new string[3, 2] { { "one", "two" }, { "three", "four" },{ "five", "six" } };// Three-dimensional array.int[,,] array3D = new int[,,] { { { 1, 2, 3 }, { 4, 5, 6 } },{ { 7, 8, 9 }, { 10, 11, 12 } } };

还可在不指定级别的情况下初始化数组

int[,] array4 = { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };

不初始化的情况下声明数组变量：

int[,] array5;array5 = new int[,] { { 1, 2 }, { 3, 4 }, { 5, 6 }, { 7, 8 } };   // OK//array5 = {{1,2}, {3,4}, {5,6}, {7,8}};   // Error

元素赋值和获取元素

可以用类似于

array[1,2]

的方式来获取数组的值和为数组赋值。

**

GetLength(0)

可以获取最外围数组的长度，

GetLength(1)

可以获得第二层数组的长度。以此类推。**为一个二维数组

duoWei

循环赋值的方式如下：

Console.WriteLine("二维数组赋值");for (int i = 0; i < duoWei.GetLength(0); i++){for (int j = 0; j < duoWei.GetLength(1); j++){duoWei[i, j] = i + j;}}

如何获取二维数组中的元素个数呢？

int[,] array = new int[,] {{1,2,3},{4,5,6},{7,8,9}};//定义一个3行3列的二维数组int row = array.Rank;//获取维数，这里指行数int col = array.GetLength(1);//获取指定维度中的元素个数，这里也就是列数了。（0是第一维，1表示的是第二维）int col = array.GetUpperBound(0)+1;//获取指定维度的索引上限，在加上一个1就是总数，这里表示二维数组的行数int num = array.Length;//获取整个二维数组的长度，即所有元的个数

来源：C#中如何获取一个二维数组的两维长度，即行数和列数？以及多维数组各个维度的长度？ – jack_Meng – 博客园 (cnblogs.com)

交错数组

交错数组是一个数组，其元素是数组，大小可能不同。 交错数组有时称为“数组的数组”。

交错数组不初始化就声明的方式如下：

int[][] ccf;ccf = new int[3][];

交错数组类似于python的多维数组，比较符合人类的直觉，一个交错数组里面包含了多个数组。

定义

可以采用类似下面的方式来声明一个交错数组：

// 定义多维数组要求每个维度的长度都相同 下面定义交错数组int[][] jiaoCuo = new int[3][]; // 该数组是由三个一维数组组成的

上面声明的数组是具有三个元素的一维数组，其中每个元素都是一维整数数组。

可使用初始化表达式通过值来填充数组元素，这种情况下不需要数组大小。 例如：

jaggedArray[0] = new int[] { 1, 3, 5, 7, 9 };jaggedArray[1] = new int[] { 0, 2, 4, 6 };jaggedArray[2] = new int[] { 11, 22 };

初始化赋值

可在声明数组时将其初始化，如：

int[][] jaggedArray2 = new int[][]{new int[] { 1, 3, 5, 7, 9 },new int[] { 0, 2, 4, 6 },new int[] { 11, 22 }};

获取元素和单个赋值

可以用类似于

jiaoCuo[1][1]

来获取单个元素的值，也可以用类似于

jiaoCuo[1][1] = 2;

来为单个元素赋值。

可以采取类似于下面的方式来进行循环赋值：

Console.WriteLine("交错数组循环赋值");// 先声明交错数组中每一个数组的长度for (int i = 0; i < 3; i++){jiaoCuo[i] = new int[i + 1];}// 然后对交错数组中的每一个元素赋值for (int i = 0; i < jiaoCuo.Length; i++){Console.WriteLine($"交错数组的第{i + 1}层");for (int j = 0; j < jiaoCuo[i].Length; j++){jiaoCuo[i][j] = i + j;Console.WriteLine(jiaoCuo[i][j]);}}

方法和属性

像数组这种储存多个变量的数据结构，最重要的就是增查删改、获取长度和数据类型转换。Array因为数组的特性，长度不可改变，所以增查删改只能有查和改。

改

Array类型用用类似于下面的方式进行改操作：

vs[0] = 12; //一维数组duoWei[1, 2] = 3; //多维数组jiaoCuo[1][1] = 2; //交错数组

查

Array类型用类似于下面的方式进行查操作：

int[] vs = new int[10];vs[0] = 12;Console.WriteLine(Array.IndexOf(vs, 12)); //0Console.WriteLine(vs.Contains(12)); // True

获取长度

可以用类似于下面这种方式来获取：

Console.WriteLine(vs.Length);Console.WriteLine(vs.Count());

交错数组的

Length

是获取所包含数组的个数，多维数组的

Length

是获取数组的元素的总个数，多维数组

GetLength(0)

GetLength(1)

可以获得第二层数组的长度。以此类推。

Array.ConvertAll()

数据类型转换

可以用

Array.ConvertAll<TInput,TOutput>(TInput[], Converter<TInput,TOutput>)

来进行数组类型的转换。

参数如下：

• array

  TInput[]

要转换为目标类型的从零开始的一维 Array。

• converter

  Converter

用于将每个元素从一种类型转换为另一种类型的 Converter。

来源：[Array.ConvertAll(TInput], Converter) 方法 (System) | Microsoft Docs

demo如下：

double[] vs3 = Array.ConvertAll(vs, item => (double)item);

切片

默认状态下只能对一维数组进行切片，或者通过交错数组获取的一维数组也可以进行切片。

切片的方式类似于

vs[1..5]

，表示vs数组从1到5，左闭右开。^1表示-1，即最后一个元素。

[^3..^1]

表示倒数第三个元素到倒数第一个元素，左闭右开。

获取单个元素和赋值

可以采用下面的方式来获取单个元素和为单个元素单独赋值：

// 一维数组Console.WriteLine(vs[1]);vs[1] = 2;// 多维数组Console.WriteLine(duoWei[1, 2]);duoWei[1, 2] = 3;// 交错数组Console.WriteLine(jiaoCuo[1][0]);jiaoCuo[1][0] = 0;

Array.ForEach

循环

System.Array里面也有ForEach方法，这是用于Array的。

demo：

Array.ForEach(vs, item => Console.WriteLine(item));

ArrayList

定义

用类似于下面的三种方式中的任意一种来声明ArrayList：

可以将Arraylist看作是一种长度可以自由变换，可以包含不同数据类型元素的数组。

初始化赋值

可以采用类似于下面的方式来初始化赋值：

ArrayList arrayList1 = new ArrayList() { 12, 334, 3, true };

循环

循环可以用for和foreach。

foreach (var item in arrayList){Console.WriteLine(item);}

方法和属性

和

list<T>

类似，但是没有

ConvertAll

方法。ArrayList本身没有ForEach方法，但是也可以用传统的foreach方法（就像前面提到的ArrayList的循环那样）。

具体的方法和属性请查看List部分的方法和属性

List<T>

定义

用类似于下面的三种方式中的任意一种来声明

List<T>

：

初始化

用类似于下面的方式在声明时初始化：

List<string> listA = new List<string>() { "hello", " ", "wrold" };

循环

List<T>

有一个名称为

ForEach

的方法：

public void ForEach (Action<T> action);

该方法的本质是要对 List 的每个元素执行的 Action 委托。Action 的参数即为

List<T>

在循环过程中的每个元素。

demo如下：

// 声明List<string> listA = new List<string>() { "hello", " ", "wrold" };// 循环var i = 0;listA.ForEach(item =>{Console.WriteLine($"第{i + 1}个");Console.WriteLine(item);i++;});

方法和属性

从获取长度、增查删改、数据类型转换、切片和循环来解析。其中除了数据类型转换和

List<T>

类型本身就拥有的ForEach方法外，都适用于ArrayList。

先声明一个

List<string>

作为演示的基础：

List<string> listA = new List<string>() { "hello", " ", "wrold" };

属性 长度

Count属性可以获取长度

Console.WriteLine(listA.Count);

属性 取值

Console.WriteLine(listA[0]);

增

即增加元素，可以用Add方法：

listA.Add("12");

查

IndexOf获取所在位置，Contains获取是否包含。

Console.WriteLine(listA.IndexOf("12"));Console.WriteLine(listA.Contains("12"));

删

Remove根据数据删除，RemoveAt根据位置删除。

listA.Remove("12");listA.RemoveAt(1);

改

可以用类似于

listA[1] = "改变";

的方式来修改元素内容。

切片

可以用

GetRange(int index, int count)

来进行切片操作，第一个参数是切片开始的位置，第二个参数是切片的数量，即从index开始往后数几个数。

Console.WriteLine(listA.GetRange(1, 1).Count);

循环

List<T>

有一个名称为

ForEach

的方法，该方法的本质是要对 List 的每个元素执行的 Action 委托。Action 的参数即为

List<T>

在循环过程中的每个元素。

demo如下：

// 声明List<string> listA = new List<string>() { "hello", " ", "wrold" };// 循环var i = 0;listA.ForEach(item =>{Console.WriteLine($"第{i + 1}个");Console.WriteLine(item);i++;});

数据类型转换

可以用ConvertAll来对数组的数据类型进行转换，这是

List<T>

自带的方法。System.Array里面也有ConvertAll方法，这是用于Array的。

List<object> listObject = listA.ConvertAll(s => (object)s);

区别

List<T>

Array最大的好处就是切片友好，可以使用类似于

[1..3]

的方式切片，这是比

GetRange

更加直观的切片方式。

List<T>

类型可以通过ToArray的方法来转变成Array。

Array

,

ArrayList

and

List<T>

之间的转换

关于这一部分的demo代码详情可从Array,ArrayList and List之间的转换 · sogeisetsu/Solution1@88f27d6 (github.com)获得。

先分别声明这三种数据类型。

// 声明数组int[] a = new int[] { 1,3,4,5,656,-1 };// 声明多维数组int[,] aD = new int[,] { { 1, 2 }, { 3, 4 } };// 声明交错数组int[][] aJ = new int[][] {new int[]{ 1,2,3},new int[]{ 1}};// 声明ArrayListArrayList b = new ArrayList() { 1, 2, 344, "233", true };// 声明List<T>List<int> c = new List<int>();

Array转ArrayList

// 数组转ArrayListArrayList aToArrayList = new ArrayList(a);

Array转

List<T>

List<int> aToList = new List<int>(a);List<int> aToLista = a.ToList();

List<T>

转Array

int[] cToList = c.ToArray();

List<T>

转ArrayList

ArrayList cToArrayList = new ArrayList(c);

ArrayList转Array

在转换的过程中，会丢失数据类型的准确度，简单来说就是转换成的Array会变成object

// ArrayList转Arrayobject[] bToArray = b.ToArray();

这种转换的意义不大，如果转换完之后再强行用Array.ConvertAll方法来进行数据类型的转换，很有可能会出现诸如

Unable to cast object of type \'System.String\' to type \'System.Int32\'.

的错误，这是因为ArrayList本身成员就可以不是单一类型。

数组的打印

Array的打印

对于Array的打印，我找到了四种方式，如下：

• 调用

  Array.ForEach

  Array.ForEach(a, item => Console.WriteLine(item));

• 传统

  forEach

  foreach (var item in a){Console.WriteLine(item);}

• 传统

  for

  for (int i = 0; i < a.Count(); i++){Console.WriteLine(a[i]);}

• string.Join

  Console.WriteLine(string.Join("\\t", a));

ArrayList的打印

ArrayList的打印我知道的就只有传统的for和foreach两种方式。

List<T>

的打印

List<T>

的打印除了传统的for和foreach两种方式之外，还有

List<T>

本身自带的foreach：

var i = 0;listA.ForEach(item =>{Console.WriteLine($"第{i + 1}个");Console.WriteLine(item);i++;});

请注意：ArrayList和

List<T>

string.Join

Array.ForEach

两种方式来打印数组。

键值对集合

可以用键来访问元素的集合称之为键值对集合，这是一个笔者私自创造的名词，他们属于集合的一部分。在很多时候，我们所所称的集合就是专指键值对集合。键值对集合每一项都有一个键/值对。键用于访问集合中的项目。

HashTable

表示根据键的哈希代码进行组织的键/值对的集合。

Hashtable的Key和Value都是object类型，所以在使用值类型的时候，必然会出现装箱和拆箱的操作。所以性能会比较弱。

构造函数

HashTable的构造函数有很多，具体可以查看Hashtable 类 (System.Collections) | Microsoft Docs

最常见的就是：

Hashtable 对象名 = new Hashtable ();

Hashtable中key-value键值对均为object类型，所以Hashtable可以支持任何类型的keyvalue键值对，任何非 null 对象都可以用作键

用诸如下面这样的方式来将null作为hashtable的一部分，会

报System.ArgumentNullException:“Key cannot be null. Arg_ParamName_Name”

的错误。

Hashtable hashtable = new Hashtable();int? a = null;hashtable.Add(a, "123");Console.WriteLine(a);

方法和属性

Hashtable 类中常用的属性和方法如下表所示。

取值

每个元素都是存储在对象中的键/值对 DictionaryEntry 。 键不能为

null

，但值可以为。

可以用类似于

集合名.[键]

的方式取值。HashTable的每一个元素都是DictionaryEntry类，这个类有两个属性分别是

Key

和

Value

，可以获取每一个元素的键和值。因为HashTable是无序排列，所以只能通过foreach来获取DictionaryEntry。

foreach (DictionaryEntry item in hashtable){Console.WriteLine(item);Console.WriteLine(item.Key);Console.WriteLine(item.Value);Console.WriteLine("-=-=-=-=-=-=-=-=-=");}

不建议使用

Hashtable

类进行新的开发。 相反，我们建议使用泛型 Dictionary 类。 有关详细信息，请参阅 GitHub 上 不应使用非泛型集合 。

来源：Hashtable 类 (System.Collections) | Microsoft Docs

SortedList

表示键/值对的集合，这些键值对按键排序并可按照键和索引访问。

SortedList

有两种，一种是System.Collections.SortedList，一种是System.Collections.Generic.SortedList。后者使用了泛型，成员类型单一，更安全且性能更优秀。

不建议使用

SortedList

类进行新的开发。 相反，我们建议使用泛型 System.Collections.Generic.SortedList 类。 有关详细信息，请参阅 GitHub 上 不应使用非泛型集合 。

来源：SortedList 类 (System.Collections) | Microsoft Docs

SortedList对象在内部维护两个用于存储列表元素的数组; 即，一个数组用于存储键，另一个数组用于关联值。 每个元素都是一个可作为对象进行访问的键/值对 DictionaryEntry 。 键不能为

null

，但值可以为。

SortedList 集合中所使用的属性和方法与 Hashtable 比较类似，这里不再赘述。它的特点就是可以用索引来访问。

构造函数

构造函数有很多，可以查看SortedList 类 (System.Collections) | Microsoft Docs。最常用的就是：

SortedList sortedList = new SortedList();

取值

既可以用类似于

集合名.[键]

的方式取值，也可以用GetKey(Int32)来获取建和用GetByIndex(Int32)来获取值。顺序为加入元素的顺序

for (int i = 0; i < sortedList.Count; i++){Console.WriteLine($"{sortedList.GetKey(i)}\\t{sortedList.GetByIndex(i)}");}

Dictionary

在单线程情况下，是所有集合类型中最快的。简称

Dict

。

本质上是HsashTable的泛型类。因为Hashtable的Key和Value都是object类型，所以在使用值类型的时候，必然会出现装箱和拆箱的操作，因此性能肯定是不如Dictionary的，在此就不做过多比较了。

只要对象用作中的键 Dictionary ，它就不得以任何影响其哈希值的方式进行更改。 根据字典的相等比较器，中的每个键都 Dictionary 必须是唯一的。 键不能为

null

TValue

。

构造方法

最常见的构造方法就是下面这个，其他的请参考Dictionary 类 (System.Collections.Generic) | Microsoft Docs

Dictionary<int, string> dictionary = new Dictionary<int, string>();

其他的方法、属性和取值方式和HashTable一致，唯一的区别就是由于 Dictionary 是键和值的集合，因此元素类型不是键的类型或值的类型。 相反，**元素类型是 KeyValuePair 键类型和值类型的。**而HashTable每个元素都是一个可作为对象进行访问的键/值对 DictionaryEntry。

foreach (KeyValuePair<int, string> item in dictionary){Console.WriteLine($"{item.Key}\\t{item.Value}\\tover");}

单线程程序中推荐使用 Dictionary, 有泛型优势, 且读取速度较快, 容量利用更充分。多线程程序中推荐使用 Hashtable, 默认的 Hashtable 允许单线程写入, 多线程读取, 对 Hashtable 进一步调用 Synchronized() 方法可以获得完全线程安全的类型. 而 Dictionary 非线程安全, 必须人为使用 lock 语句进行保护, 效率大减。

区别

set

SortedDictionary<TKey,TValue>

互相转换

**我认为集合的类型转换意义不大，因为集合的意义就是一个储存数据的引用类型。程序一般在设计之初就已经通过未来可能的使用场景确定了集合的类型。**就像一个类有一个int类型的属性，一般不应该在后面使用的时候去把它转为Double。

这里只讲HashTable和Dictionary之间的转换。

像非泛型类和泛型类之间的转换，必须在转换之初就有类型安全的考虑，否则可能出现很多错误。

HashTable 转 Dict

// hashtable 转 DictDictionary<int, int> dictionary = new Dictionary<int, int>();foreach (DictionaryEntry item in hashtable){dictionary.Add((int)item.Key, (int)item.Value);}

Dict 转 HashTable

// Dict转HashtableHashtable hashtable1 = new Hashtable(dictionary);

集合的打印

使用传统的

foreach

可以非常方便地进行打印。在打印的时候需要考虑到不同类型的集合元素类型的不同。虽然var可以帮助我们不用去记忆那些讨厌的类型名称，但是在某些时候IDE会因为使用了var而无法让代码自动提醒功能正常工作。

foreach (var item in dictionary){Console.WriteLine($"key:{item.Key}\\tvalue:{item.Value}");}

建议使用泛型集合

微软官方建议使用泛型集合，因为

non-generic collections

有Error prone和Less performant的问题，微软提供了用以替换

non-generic collections

的类，现在摘录如下：

ArrayList

List

CaseInsensitiveComparer

StringComparer.OrdinalIgnoreCase

CaseInsensitiveHashCodeProvider

StringComparer.OrdinalIgnoreCase

CollectionBase

Collection

Comparer

Comparer

DictionaryBase

Dictionary

KeyedCollection

DictionaryEntry

KeyValuePair

Hashtable

Dictionary

Queue

Queue

ReadOnlyCollectionBase

ReadOnlyCollection

SortedList

SortedList

Stack

Stack

来源：platform-compat/DE0006.md at master · dotnet/platform-compat (github.com)

HashSet<T>

HashSet 是一个优化过的无序集合，提供对元素的高速查找和高性能的

set集合

操作，而且 HashSet 是在 .NET 3.5 中被引入的，在

System.Collection.Generic

命名空间下。

只要泛型类允许null，HashSet就允许元素为null。

HashSet会在添加元素的过程中自动去除重复的值，并且不会报错。

HashSet类提供高性能的设置操作。 集是不包含重复元素的集合，其元素无特定顺序。

HashSet的一些特性如下:

​ a. HashSet中的值不能重复且没有顺序。

​ b. HashSet的容量会按需自动添加。

HashSet并非键值对集合。

HashSet 只能包含唯一的元素，它的内部结构也为此做了专门的优化，值得注意的是，HashSet 也可以存放单个的 null 值，可以得出这么一个结论：如何你想拥有一个具有唯一值的集合，那么 HashSet 就是你最好的选择，何况它还具有超高的检索性能。

构造函数

比较常见的构造函数就像下面这样，更多的构造函数请看HashSet 类 (System.Collections.Generic) | Microsoft Docs。

HashSet<int> hashSet = new HashSet<int>();

方法和属性

具体的方法和属性请查看HashSet 类 (System.Collections.Generic) | Microsoft Docs。

像常见的clear、remove、add、count之类的方法和属性不再赘述。

HashSet 的 set操作

HashSet类主要是设计用来做高性能集运算的，例如对两个集合求交集、并集、差集等。

为了方便理解，先画一个图，A和B为两个浅蓝色的正圆，C为A和B的交集。后面会用到这张图里面的内容。

定义两个HashSet，命名为

setA

和

setB

，分别代表图中的A和B。

IsProperSubsetOf 真子集

确定 HashSet 对象是否为指定集合的真子集。

// 确定setA是否为setB的真子集Console.WriteLine(setA.IsProperSubsetOf(setB)); // TrueConsole.WriteLine(setC.IsProperSubsetOf(setB)); // False

UnionWith 并集

修改当前 HashSet 对象以包含存在于该对象中、指定集合中或两者中的所有元素。其实就是修改当前集合为两个集合的并集。求图中的A+B。

// 求两个的并集setA.UnionWith(setB);// 现在setA就是两个集合的并集foreach (var item in setA){Console.WriteLine(item);}

IntersectWith 交集

将当前集合变为两个集合的交集，求图中的C。

// 求交集setA.IntersectWith(setB);// 现在setA就是两个的交集foreach (var item in setA){Console.WriteLine(item);}

ExceptWith 差集

去除交集，从当前 HashSet 对象中移除指定集合中的所有元素。本质上是求图中的A-C。

// 去除交集，从当前 HashSet<T> 对象中移除指定集合中的所有元素。setA.ExceptWith(setB);foreach (var item in setA){Console.WriteLine(item);}

SymmetricExceptWith

仅包含存在于该对象中或存在于指定集合中的元素（但并非两者）。本质上是

(A-C)+(B-C)

。

//仅包含存在于该对象中或存在于指定集合中的元素（但并非两者）。setA.SymmetricExceptWith(setB);foreach (var item in setA){Console.WriteLine(item);}

Json解析

json是一种类似于通过键值对来储存数据的格式，在对数据库进行操作的时候，通常会把类数据转为json格式，然后储存在数据库里面，使用的时候再将json转为类的实例化对象。java的springboot框架的一整套解决方案里面可以通过mybatis和fastjson完成这个操作。在web的前后端数据传输中，一般也是用json作为数据的载体，JavaScript有着对json比较完备的支持。

Json格式概述

• 基础

  概念： JavaScript Object Notation JavaScript对象表示法

• json现在多用于存储和交换文本信息的语法

• 进行数据的传输

• JSON 比 XML 更小、更快，更易解析。

1. 语法：

2. 基本规则

• 数据在名称/值对中：json数据是由键值对构成的

• 键用引号(单双都行)引起来，也可以不使用引号

• 值得取值类型：

1. 数字（整数或浮点数）

2. 字符串（在双引号中）

3. 逻辑值（true 或 false）

4. 数组（在方括号中） {"persons":[,]}

5. 对象（在花括号中） {"address":{"province"："陕西"….}}

6. null

• 数据由逗号分隔：多个键值对由逗号分隔

• 花括号保存对象：使用定义json 格式

• 方括号保存数组：[]

1. JavaScript

   获取数据:

1. json对象.键名

2. json对象["键名"]

3. 数组对象[索引]

4. 遍历

解析

使用 C# 对 JSON 进行序列化和反序列化 – .NET | Microsoft Docs

会用到两个名词，序列化和反序列化，其中序列化是指将实例对象转换成json格式的字符串，反序列化则是逆向前面序列化的过程。

在序列化的过程中，**默认情况下会只序列化公共读写的属性，可以通过

System.Text.Json.Serialization

的

JsonInclude

特性或者

JsonSerializerOptions

的

IncludeFields

属性来包含公有字段。通过

System.Text.Json.Serialization

的

JsonInclude

特性可以来自定义可以序列化的非公共属性访问器（即属性的访问修饰符为public，但是set访问器和get访问器的任意一方为非public）。**这可能对使用惯了java的人来说不适应，事实上这是一种很合理的序列化要求，默认状况下，序列化器会序列化对象中的所有可读属性，反序列化所有可写属性，这种方式尊重了访问修饰符的作用。**也可用开源的

Newtonsoft.Json

来序列化非公有属性。**现在很多编程语言（包括.NET）能通过反射来获取私有属性本身就是不合理的，从

.NET core

能明显的感觉到.NET团队出于安全的考虑在限制反射的使用。

需要用到的

namespace

：

using System.Text.Encodings.Web;using System.Text.Json;using System.Text.Json.Serialization;using System.Text.Unicode;

• 用

  System.Text.Json

  的**

  JsonSerializer.Serialize

  方法可以进行序列化**。

• 用

  System.Text.Json

  的**

  JsonSerializer.Deserialize

  方法可以进行反序列化**。

• 用

  System.Text.Json.Serialization

  可以要序列化的类添加必要的特性，比如

  JsonPropertyName

  为属性序列化时重命名，再比如

  JsonInclude

  来定义序列化时要包含的字段。

• 用

  System.Text.Encodings.Web

  和

  System.Text.Unicode

  来让特定的字符集在序列化的时候能够正常序列化而不是被转义成为

  \\uxxxx

  ，其中

  xxxx

  为字符的 Unicode 代码。事实上，默认情况下，序列化程序会转义所有非 ASCII 字符。

序列化

只将实例化对象转变成json字符串，假设有一个实例化对象

weatherForecast

，序列化方式如下：

string jsonString = JsonSerializer.Serialize(weatherForecast);

反序列化

指将json字符串序列化成实例化对象，书接前文，方式如下：

weatherForecast = JsonSerializer.Deserialize<WeatherForecastWithPOCOs>(jsonString);

JsonSerializerOptions

可以通过

JsonSerializerOptions

来指定诸如是否整齐打印和忽略Null值属性等信息。使用方式为将

JsonSerializerOptions

实例化之后再当作

JsonSerializer.Serialize

和

JsonSerializer.Deserialize

的参数。

关于

JsonSerializerOptions

的属性可以查看如何使用 System.Text.Json 实例化 JsonSerializerOptions | Microsoft Docs

先实例化一个**

JsonSerializerOptions

对象，在初始化器里面定义各种属性**：

JsonSerializerOptions jsonSerializerOptions = new JsonSerializerOptions(){// 整齐打印WriteIndented = true,// 忽略值为Null的属性IgnoreNullValues = true,// 设置Json字符串支持的编码，默认情况下，序列化程序会转义所有非 ASCII 字符。 即，会将它们替换为 \\uxxxx，其中 xxxx 为字符的 Unicode// 代码。 可以通过设置Encoder来让生成的josn字符串不转义指定的字符集而进行序列化 下面指定了基础拉丁字母和中日韩统一表意文字的基础Unicode 块// (U+4E00-U+9FCC)。 基本涵盖了除使用西里尔字母以外所有西方国家的文字和亚洲中日韩越的文字Encoder = JavaScriptEncoder.Create(UnicodeRanges.BasicLatin, UnicodeRanges.CjkUnifiedIdeographs),// 反序列化不区分大小写PropertyNameCaseInsensitive = true,// 驼峰命名PropertyNamingPolicy = JsonNamingPolicy.CamelCase,// 对字典的键进行驼峰命名DictionaryKeyPolicy = JsonNamingPolicy.CamelCase,// 序列化的时候忽略null值属性DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,// 忽略只读属性，因为只读属性只能序列化而不能反序列化，所以在以json为储存数据的介质的时候，序列化只读属性意义不大IgnoreReadOnlyFields = true,// 不允许结尾有逗号的不标准jsonAllowTrailingCommas = false,// 不允许有注释的不标准jsonReadCommentHandling = JsonCommentHandling.Disallow,// 允许在反序列化的时候原本应为数字的字符串（带引号的数字）转为数字NumberHandling = JsonNumberHandling.AllowReadingFromString,// 处理循环引用类型，比如Book类里面有一个属性也是Book类ReferenceHandler = ReferenceHandler.Preserve};

然后在序列化和反序列化的时候**

jsonSerializerOptions

**对象当作参数传给

JsonSerializer.Serialize

和

JsonSerializer.Deserialize

：

string jsonBookA = JsonSerializer.Serialize(bookA, jsonSerializerOptions);// 反序列化BookA bookA1 = JsonSerializer.Deserialize<BookA>(jsonBookA, jsonSerializerOptions);

JsonSerializerOptions

常用属性概述

WriteIndented

IgnoreNullValues

Encoder

Encoder = JavaScriptEncoder.Create(UnicodeRanges.BasicLatin, UnicodeRanges.CjkUnifiedIdeographs)

PropertyNameCaseInsensitive

PropertyNamingPolicy

JsonNamingPolicy.CamelCase

DictionaryKeyPolicy

DefaultIgnoreCondition

JsonIgnoreCondition.WhenWritingDefault

IgnoreReadOnlyProperties

AllowTrailingCommas

ReadCommentHandling

NumberHandling

NumberHandling = JsonNumberHandling.AllowReadingFromString

ReferenceHandler

ReferenceHandler = ReferenceHandler.Preserve

IncludeFields

false

System.Text.Json.Serialization

特性

可以为将要序列化和被反序列化而生成的类的属性和字段添加特性。

JsonInclude 包含特定public字段和非公共属性访问器

在序列化或反序列化时，使用 JsonSerializerOptions.IncludeFields 全局设置或 [JsonInclude] 特性来包含字段（必须是public），当应用于某个属性时，指示非公共的 getter 和 setter 可用于序列化和反序列化。 不支持非公共属性。

demo：

/// <summary>/// 时间戳/// </summary>[JsonInclude]public long timestamp = DateTimeOffset.Now.ToUnixTimeMilliseconds();/// <summary>/// 书的名称/// </summary>[JsonInclude]public string Name { private get; set; } = "《书名》";

JsonPropertyName 自定义属性名称

若要设置单个属性的名称，请使用 [JsonPropertyName] 特性。

此特性设置的属性名称：

• 同时适用于两个方向（序列化和反序列化）。
• 优先于属性命名策略。

demo：

/// <summary>/// 作者/// </summary>[JsonPropertyName("作者")]public string Author{get { return _author; }set { _author = value; }}

JsonIgnore 忽略单个属性

阻止对属性进行序列化或反序列化。

demo：

/// <summary>/// 书的出版商/// </summary>[JsonIgnore]public string OutCompany { get => _outCompany; set => _outCompany = value; }

JsonExtensionData 处理溢出 JSON

反序列化时，可能会在 JSON 中收到不是由目标类型的属性表示的数据。可以将这些无法由目标类型的属性表示的数据储存在一个

Dictionary<string, JsonElement>

字典里面，方式如下：

/// <summary>/// 储存反序列化时候的溢出数据/// </summary>[JsonExtensionData]public Dictionary<string, JsonElement> ExtensionData { get; set; }

笔者的选择

在笔者的开发经验当中，json用的最多的就是前后端数据传输和数据库储存数据。对

jsonSerializerOptions

往往会选择这几个选项：

JsonSerializerOptions jsonSerializerOptions = new JsonSerializerOptions(){// 整齐打印WriteIndented = true,// 忽略值为Null的属性IgnoreNullValues = true,// 设置Json字符串支持的编码，默认情况下，序列化程序会转义所有非 ASCII 字符。 即，会将它们替换为 \\uxxxx，其中 xxxx 为字符的 Unicode// 代码。 可以通过设置Encoder来让生成的josn字符串不转义指定的字符集而进行序列化 下面指定了基础拉丁字母和中日韩统一表意文字的基础Unicode 块// (U+4E00-U+9FCC)。 基本涵盖了除使用西里尔字母以外所有西方国家的文字和亚洲中日韩越的文字Encoder = JavaScriptEncoder.Create(UnicodeRanges.BasicLatin, UnicodeRanges.CjkUnifiedIdeographs, UnicodeRanges.CjkSymbolsandPunctuation),// 反序列化不区分大小写PropertyNameCaseInsensitive = true,// 驼峰命名PropertyNamingPolicy = JsonNamingPolicy.CamelCase,// 对字典的键进行驼峰命名DictionaryKeyPolicy = JsonNamingPolicy.CamelCase,// 忽略只读属性，因为只读属性只能序列化而不能反序列化，所以在以json为储存数据的介质的时候，序列化只读属性意义不大IgnoreReadOnlyProperties  = true,// 允许在反序列化的时候原本应为数字的字符串（带引号的数字）转为数字NumberHandling = JsonNumberHandling.AllowReadingFromString};

尽量不使用

JsonPropertyName

特性，对有可能会用到json反序列化的类一定会用到

JsonExtensionData

特性来储存可能存在的溢出数据。

JsonIgnore

和

JsonInclude

会广泛的使用而不用

JsonSerializerOptions

的

IncludeFields

来序列化所有字段。

LICENSE

已将所有引用其他文章之内容清楚明白地标注，其他部分皆为作者劳动成果。对作者劳动成果做以下声明：

copyright © 2021 苏月晟，版权所有。

本作品由苏月晟采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。