10有免费建网站,电子商务营销案例,消防公司宣传册设计样本,网页设计要用什么软件#x1f380;#x1f380;#x1f380;代码之美系列目录#x1f380;#x1f380;#x1f380;
一、C# 命名规则规范 二、C# 代码约定规范 三、C# 参数类型约束 四、浅析 B/S 应用程序体系结构原则 五、浅析 C# Async 和 Await 六、浅析 ASP.NET Core SignalR 双工通信 …代码之美系列目录
一、C# 命名规则规范 二、C# 代码约定规范 三、C# 参数类型约束 四、浅析 B/S 应用程序体系结构原则 五、浅析 C# Async 和 Await 六、浅析 ASP.NET Core SignalR 双工通信 七、浅析 ASP.NET Core 和 MongoDB 创建 Web API 八、浅析 ASP.NET Web UI 框架 Razor Pages/MVC/Web API/Blazor 九、如何使用 MiniProfiler WebAPI 分析工具 十、浅析 .NET Core 中各种 Filter 十一、C#.Net筑基-类型系统 十二、C#.Net 筑基-运算符 十三、C#.Net筑基-解密委托与事件 十四、C#.Net筑基-集合知识大全 十五、C#.Net筑基 - 常见类型 十六、C#.NET体系图文概述—2024最全总结 十七、C# 强大无匹的模式匹配让代码更加优雅 文章目录 代码之美系列目录前言一、何时使用记录1.1 值相等性1.2 不可变性 二、记录与类和结构的区别三、属性定义的位置语法四、 非破坏性变化五、用于显示的内置格式设置六、继承6.1 派生记录类型中的位置参数6.2 继承层次结构中的相等性6.3 派生记录中的 with 表达式6.4 派生记录中的 PrintMembers 格式设置6.5 派生记录中的解构函数行为 七、泛型约束代码之美系列目录 前言
C# 中的 记录 是一个 类 或 结构它为使用数据模型提供特定的 语法 和 行为 。 record 修饰符指示编译器合成对主要角色存储数据的类型有用的成员。 这些成员包括支持值相等的 ToString() 和成员的重载。
一、何时使用记录
在下列情况下请考虑使用记录 而不是 类或结构
你想要定义依赖 值相等性 的数据模型。你想要定义对象 不可变 的类型。
1.1 值相等性
对记录来说值相等性 是指如果 记录类型 的两个变量 类型 相匹配且所有 属性 和 字段 值都相同那么记录类型的两个变量是相等的。 对于其他引用类型例如类相等性默认指引用相等性除非执行了值相等性。 也就是说如果类的两个变量引用同一个对象则这两个变量是相等的。 确定两个记录实例的相等性的方法和运算符使用 值相等性 。
并非所有数据模型都适合使用值相等性。 例如Entity Framework Core 依赖引用相等性来确保它对概念上是一个实体的实体类型只使用一个实例。 因此记录类型 不适合 用作 Entity Framework Core 中的实体类型。
如果不替代或替换相等性方法则声明的类型将控制如何定义相等性
对于 class 类型如果两个对象引用内存中的同一对象则这两个对象相等。 对于 struct 类型如果两个对象是相同的类型并且存储相同的值则这两个对象相等。 对于具有 record 修饰符record class、record struct 和 readonly record struct的类型如果两个对象是相同的类型并且存储相同的值则这两个对象相等。 record struct 的相等性定义与 struct 的相等性定义相同。 不同之处在于对于 struct 实现处于 ValueType.Equals(Object) 中并且依赖反射。 对于记录实现由编译器合成并且使用声明的数据成员。
一些数据模型需要引用相等性。 例如Entity Framework Core 依赖于引用相等性来确保它对概念上是一个实体的实体类型只使用一个实例。 因此记录和记录结构不适合用作 Entity Framework Core 中的实体类型。
下面的示例说明了记录类型的值相等性
public record Person(string FirstName, string LastName, string[] PhoneNumbers);public static void Main()
{var phoneNumbers new string[2];Person person1 new(Nancy, Davolio, phoneNumbers);Person person2 new(Nancy, Davolio, phoneNumbers);Console.WriteLine(person1 person2); // output: Trueperson1.PhoneNumbers[0] 555-1234;Console.WriteLine(person1 person2); // output: TrueConsole.WriteLine(ReferenceEquals(person1, person2)); // output: False
}1.2 不可变性
不可变类型 会 阻止 你在对象实例化后 更改 该对象的任何 属性 或 字段值。 如果你需要一个类型是线程安全的或者需要哈希代码在哈希表中能保持不变那么不可变性很有用。 记录为创建和使用 不可变类型 提供了简洁的语法。
positional record 和 positional readonly record struct 声明 init-only 属性 。 positional record struct 声明 read-write 属性。 可以替代这些默认值中的任何一个如上个部分中所示。
如果你需要一个以数据为中心的类型是线程安全的或者需要使哈希表中的哈希代码保持不变那么不可变性很有用。 但不可变性并不是适用于所有的数据场景。 例如Entity Framework Core 就 不支持通过不可变实体类型进行更新。
public record Person(string FirstName, string LastName, string[] PhoneNumbers);public static void Main()
{Person person new(Nancy, Davolio, new string[1] { 555-1234 });Console.WriteLine(person.PhoneNumbers[0]); // output: 555-1234person.PhoneNumbers[0] 555-6789;Console.WriteLine(person.PhoneNumbers[0]); // output: 555-6789
}init-only 属性无论是通过位置参数record class 和 readonly record struct创建的还是通过指定 init 访问器创建的都具有浅的不可变性。 初始化后将不能更改值型属性的值或引用型属性的引用。 不过引用型属性引用的数据是可以更改的。 下面的示例展示了引用型不可变属性的内容本例中是数组是可变的
二、记录与类和结构的区别
声明 和 实例化 类 或 结构 时使用的语法与 操作记录 时的 相同 。 只是将 class 关键字替换为 record或者使用 record struct 而不是 struct 。 同样地记录类支持相同的表示 继承关系的语法。 记录与类的区别如下所示
可在主构造函数中使用位置参数来创建和实例化具有不可变属性的类型。在类中指示引用相等性或不相等的方法和运算符例如 Object.Equals(Object) 和 在记录中指示值相等性或不相等。可使用 with 表达式对不可变对象创建在所选属性中具有新值的副本。记录的 ToString 方法会创建一个格式字符串它显示对象的类型名称及其所有公共属性的名称和值。记录可从另一个记录 继承 。 但记录不可从类继承类也不可从记录继承。
记录结构与结构的不同之处是编译器合成了方法来确定相等性和 ToString。 编译器为位置记录结构合成 Deconstruct 方法。
编译器为 record class 中的每个主构造函数参数合成一个公共仅初始化属性。 在 record struct 中编译器合成公共读写属性。 编译器不会在不包含 record 修饰符的 class 和 struct 类型中创建主构造函数参数的属性。
三、属性定义的位置语法
在创建实例时可以使用位置参数来声明记录的属性并初始化属性值
public record Person(string FirstName, string LastName);public static void Main()
{Person person new(Nancy, Davolio);Console.WriteLine(person);// output: Person { FirstName Nancy, LastName Davolio }
}当你为属性定义使用位置语法时编译器将创建以下内容
记录声明中提供的每个位置参数的公共自动实现属性。 对于 record 和 readonly record struct 类型为 record 属性。对于 record struct 类型为读写属性。 主构造函数它的参数与记录声明上的位置参数匹配。对于 record struct 类型则是将每个字段设置为其默认值的无参数构造函数。一个 Deconstruct 方法对记录声明中提供的每个位置参数都有一个 out 参数。 此方法解构了使用位置语法定义的属性它忽略了使用标准属性语法定义的属性。
你可能想要将属性添加到编译器从记录定义中创建的任何元素。 你可以向应用于位置记录属性的任何特性添加目标。 System.Text.Json.Serialization.JsonPropertyNameAttribute 记录的每个属性应用 Person 。 property: 目标指示该特性应用于编译器生成的属性。 其他值包括将该特性应用于字段的 field: 以及将该特性应用于参数的 param: 。
/// summary
/// Person record type
/// /summary
/// param nameFirstNameFirst Name/param
/// param nameLastNameLast Name/param
/// remarks
/// The person type is a positional record containing the
/// properties for the first and last name. Those properties
/// map to the JSON elements firstName and lastName when
/// serialized or deserialized.
/// /remarks
public record Person([property: JsonPropertyName(firstName)] string FirstName, [property: JsonPropertyName(lastName)] string LastName);上面的示例还演示了如何为记录创建 XML 文档注释。 你可以添加 param 标记以添加主要构造函数参数的文档。
如果生成的自动生成的属性定义不是所需的属性则可以定义自己的同名属性。 例如你可能想要更改可访问性或可变性或者为 get 或 set 访问器提供实现。 如果在源中声明属性则必须从记录的位置参数初始化该属性。 如果属性是自动实现的属性则必须初始化该属性。 如果在源中添加支持字段则必须初始化支持字段。 生成的析构函数将使用属性定义。 例如下面的示例声明了位置记录 FirstName 的 LastName 和 public 属性但将 Id 位置参数限制为 internal。 可以对记录和 record struct 类型使用此语法。
public record Person(string FirstName, string LastName, string Id)
{internal string Id { get; init; } Id;
}public static void Main()
{Person person new(Nancy, Davolio, 12345);Console.WriteLine(person.FirstName); //output: Nancy}记录类型不需要声明任何位置属性。 你可以在没有任何位置属性的情况下声明一个记录也可以声明其他字段和属性如以下示例中所示
public record Person(string FirstName, string LastName)
{public string[] PhoneNumbers { get; init; } [];
};如果使用标准属性语法来定义属性但省略了访问修饰符这些属性将隐式地 private。
四、 非破坏性变化
如果需要复制包含一些修改的实例可以使用 with 表达式来实现非破坏性变化。 with 表达式创建一个新的记录实例该实例是现有记录实例的一个副本修改了指定属性和字段。 使用对象初始值设定项语法来指定要更改的值如以下示例中所示
public record Person(string FirstName, string LastName)
{public string[] PhoneNumbers { get; init; }
}public static void Main()
{Person person1 new(Nancy, Davolio) { PhoneNumbers new string[1] };Console.WriteLine(person1);// output: Person { FirstName Nancy, LastName Davolio, PhoneNumbers System.String[] }Person person2 person1 with { FirstName John };Console.WriteLine(person2);// output: Person { FirstName John, LastName Davolio, PhoneNumbers System.String[] }Console.WriteLine(person1 person2); // output: Falseperson2 person1 with { PhoneNumbers new string[1] };Console.WriteLine(person2);// output: Person { FirstName Nancy, LastName Davolio, PhoneNumbers System.String[] }Console.WriteLine(person1 person2); // output: Falseperson2 person1 with { };Console.WriteLine(person1 person2); // output: True
}with 表达式可以设置位置属性或使用标准属性语法创建的属性。 显式声明属性必须有一个 init 或 set 访问器才能在 with 表达式中进行更改。
with 表达式的结果是一个浅的副本这意味着对于引用属性只复制对实例的引用。 原始记录和副本最终都具有对同一实例的引用。
为了对 record class 类型实现此功能编译器合成了一个克隆方法和一个复制构造函数。 虚拟克隆方法返回由复制构造函数初始化的新记录。 当使用 with 表达式时编译器将创建调用克隆方法的代码然后设置 with 表达式中指定的属性。
如果你需要不同的复制行为可以在 record class 中编写自己的复制构造函数。 如果这样做编译器不会合成方法。 如果记录是 private则使构造函数为 sealed否则使其为 protected。 编译器不会针对 record struct 类型合成复制构造函数。 虽然你可以编写一个方法但编译器不会为 with 表达式生成对它的调用。 record struct 的值在分配时进行复制。
你不能替代克隆方法也不能在任意记录类型中创建名为 Clone 的成员。 克隆方法的实际名称是由编译器生成的。
五、用于显示的内置格式设置
记录类型具有编译器生成的 ToString 方法可显示公共属性和字段的名称和值。 ToString 方法返回一个格式如下的字符串
record type name { property name value, property name value, ...}为 value 打印的字符串是 ToString() 针对属性类型返回的字符串。 在以下示例中ChildNames 是 System.Array其中 ToString 返回 System.String[]
Person { FirstName Nancy, LastName Davolio, ChildNames System.String[] }为了实现此功能编译器在 record class 类型中合成了一个虚拟 PrintMembers 方法和一个 ToString 替代。 此成员在 record struct 类型中为 private。 ToString 替代创建了一个 StringBuilder 对象它的类型名称后跟一个左括号。 它调用 PrintMembers 以添加属性名称和值然后添加右括号。 下面的示例展示了类似于合成替代中包含的代码
public override string ToString()
{StringBuilder stringBuilder new StringBuilder();stringBuilder.Append(Teacher); // type namestringBuilder.Append( { );if (PrintMembers(stringBuilder)){stringBuilder.Append( );}stringBuilder.Append(});return stringBuilder.ToString();
}你可以提供自己的 PrintMembers 实现或 ToString 替代。 本文后面的派生记录中的 PrintMembers 格式设置一节中提供了示例。 您对 ToString 的实现可能包括 sealed 修饰符以防止编译器为任何派生记录生成 ToString 实现。 可以在 record 类型的层次结构中创建一致的字符串表示形式。 派生记录仍会为所有派生属性生成一个 PrintMembers 方法。
六、继承
本部分仅适用于 record class 类型。
一条记录可以从另一条记录继承。 但是记录不能从类继承类也不能从记录继承。
6.1 派生记录类型中的位置参数
派生记录为基本记录主构造函数中的所有参数声明位置参数。 基本记录声明并初始化这些属性。 派生记录不会隐藏它们而只会创建和初始化未在其基本记录中声明的参数的属性。
下面的示例说明了具有位置属性语法的继承
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade): Person(FirstName, LastName);
public static void Main()
{Person teacher new Teacher(Nancy, Davolio, 3);Console.WriteLine(teacher);// output: Teacher { FirstName Nancy, LastName Davolio, Grade 3 }
}6.2 继承层次结构中的相等性
本部分适用于 record class 类型但不适用于 record struct 类型。 要使两个记录变量相等运行时类型必须相等。 包含变量的类型可能不同。 下面的代码示例演示了继承的相等性比较
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade): Person(FirstName, LastName);
public record Student(string FirstName, string LastName, int Grade): Person(FirstName, LastName);
public static void Main()
{Person teacher new Teacher(Nancy, Davolio, 3);Person student new Student(Nancy, Davolio, 3);Console.WriteLine(teacher student); // output: FalseStudent student2 new Student(Nancy, Davolio, 3);Console.WriteLine(student2 student); // output: True
}在此示例中所有变量都声明为 Person即使该实例是 Student 或 Teacher 的派生类型也是如此。 这些实例都具有相同的属性和相同的属性值。 但 student teacher 返回 False尽管这两个都是 Person 型变量student student2 返回 True尽管一个是 Person 变量而另一个是 Student 变量。 相等性测试依赖于实际对象的运行时类型而不是声明的变量类型。
为实现此行为编译器合成了一个 EqualityContract 属性该属性返回一个与记录类型匹配的 Type 对象。 利用 EqualityContract 相等性方法在检查相等性时就可以比较对象的运行时类型。 如果记录的基类型为 object 则此属性为 virtual 。 如果基类型是其他记录类型则此属性是一个替代。 如果记录类型为 sealed 则此属性实际上是 sealed 因为类型是 sealed 。
在代码比较派生类型的两个实例时合成的相等性方法会检查基类型和派生类型的所有数据成员是否相等。 合成的 GetHashCode 方法从基类型和派生的记录类型中声明的所有数据成员中使用 GetHashCode 方法。 包含所有声明字段的数据成员 record 以及任何自动实现的属性的编译器合成后盾字段。
6.3 派生记录中的 with 表达式
with 表达式结果的运行时间类型与表达式操作数相同 运行时类型的所有属性都会被复制但你只能设置编译时类型的属性如下面的示例所示
public record Point(int X, int Y)
{public int Zbase { get; set; }
};
public record NamedPoint(string Name, int X, int Y) : Point(X, Y)
{public int Zderived { get; set; }
};public static void Main()
{Point p1 new NamedPoint(A, 1, 2) { Zbase 3, Zderived 4 };Point p2 p1 with { X 5, Y 6, Zbase 7 }; // Cant set Name or ZderivedConsole.WriteLine(p2 is NamedPoint); // output: TrueConsole.WriteLine(p2);// output: NamedPoint { X 5, Y 6, Zbase 7, Name A, Zderived 4 }Point p3 (NamedPoint)p1 with { Name B, X 5, Y 6, Zbase 7, Zderived 8 };Console.WriteLine(p3);// output: NamedPoint { X 5, Y 6, Zbase 7, Name B, Zderived 8 }
}6.4 派生记录中的 PrintMembers 格式设置
派生记录类型的合成 PrintMembers 方法调用基实现。 结果是派生类型和基类型的所有公共属性和字段都包含在 ToString 输出中如以下示例中所示
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade): Person(FirstName, LastName);
public record Student(string FirstName, string LastName, int Grade): Person(FirstName, LastName);public static void Main()
{Person teacher new Teacher(Nancy, Davolio, 3);Console.WriteLine(teacher);// output: Teacher { FirstName Nancy, LastName Davolio, Grade 3 }
}你可以提供自己的 PrintMembers 方法的实现。 如果这样做请使用以下签名
对于派生自 sealed 的 object记录不声明基本记录使用 private bool PrintMembers(StringBuilder builder)对于从另一个记录派生的 sealed 记录注意封闭类型是 sealed 因此该方法实际上是 sealedprotected override bool PrintMembers(StringBuilder builder)对于非 sealed 且派生自对象的记录使用 protected virtual bool PrintMembers(StringBuilder builder);对于非 sealed 且派生自其他记录的记录使用 protected override bool PrintMembers(StringBuilder builder);
下面的代码示例替换了合成的 PrintMembers 方法一个是派生自对象的记录类型另一个是派生自另一条记录的记录类型
public abstract record Person(string FirstName, string LastName, string[] PhoneNumbers)
{protected virtual bool PrintMembers(StringBuilder stringBuilder){stringBuilder.Append($FirstName {FirstName}, LastName {LastName}, );stringBuilder.Append($PhoneNumber1 {PhoneNumbers[0]}, PhoneNumber2 {PhoneNumbers[1]});return true;}
}public record Teacher(string FirstName, string LastName, string[] PhoneNumbers, int Grade): Person(FirstName, LastName, PhoneNumbers)
{protected override bool PrintMembers(StringBuilder stringBuilder){if (base.PrintMembers(stringBuilder)){stringBuilder.Append(, );};stringBuilder.Append($Grade {Grade});return true;}
};public static void Main()
{Person teacher new Teacher(Nancy, Davolio, new string[2] { 555-1234, 555-6789 }, 3);Console.WriteLine(teacher);// output: Teacher { FirstName Nancy, LastName Davolio, PhoneNumber1 555-1234, PhoneNumber2 555-6789, Grade 3 }
}即使基记录密封了 ToString 方法编译器也会在派生记录中合成 PrintMembers。 还可以创建自己的 PrintMembers 实现。 6.5 派生记录中的解构函数行为
派生记录的 Deconstruct 方法返回编译时类型所有位置属性的值。 如果变量类型为基本记录则只解构基本记录属性除非该对象强制转换为派生类型。 下面的示例演示了如何对派生记录调用解构函数。
public abstract record Person(string FirstName, string LastName);
public record Teacher(string FirstName, string LastName, int Grade): Person(FirstName, LastName);
public record Student(string FirstName, string LastName, int Grade): Person(FirstName, LastName);public static void Main()
{Person teacher new Teacher(Nancy, Davolio, 3);var (firstName, lastName) teacher; // Doesnt deconstruct GradeConsole.WriteLine(${firstName}, {lastName});// output: Nancy, Davoliovar (fName, lName, grade) (Teacher)teacher;Console.WriteLine(${fName}, {lName}, {grade});// output: Nancy, Davolio, 3
}七、泛型约束
record 关键字是 class 或 struct 类型的修饰符。 添加 record 修饰符包括本文前面所述的行为。 没有任何泛型约束要求类型是记录。 record class 满足 class 约束。 record struct 满足 struct 约束。 有关详细信息请参阅类型参数的约束。 代码之美系列目录
一、C# 命名规则规范 二、C# 代码约定规范 三、C# 参数类型约束 四、浅析 B/S 应用程序体系结构原则 五、浅析 C# Async 和 Await 六、浅析 ASP.NET Core SignalR 双工通信 七、浅析 ASP.NET Core 和 MongoDB 创建 Web API 八、浅析 ASP.NET Web UI 框架 Razor Pages/MVC/Web API/Blazor 九、如何使用 MiniProfiler WebAPI 分析工具 十、浅析 .NET Core 中各种 Filter 十一、C#.Net筑基-类型系统 十二、C#.Net 筑基-运算符 十三、C#.Net筑基-解密委托与事件 十四、C#.Net筑基-集合知识大全 十五、C#.Net筑基 - 常见类型 十六、C#.NET体系图文概述—2024最全总结 十七、C# 强大无匹的模式匹配让代码更加优雅
