ASP.NET Core教程【三】实体字段属性、链接标签、并发数据异常、文件上传及读取
前文索引：
ASP.NET Core教程【二】从保存数据看Razor Page的特有属性与服务端验证
ASP.NET Core教程【一】关于Razor Page的知识
实体字段属性
再来看看我们的实体类
public class Movie
{
public int ID { get; set; }
public string Title { get; set; }
[Display(Name = "Release Date")]
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
public string Genre { get; set; }
public decimal Price { get; set; }
}说明，上面的代码需要引用：using System.ComponentModel.DataAnnotations;
Display属性标志这个字段在页面上显示的时候，需要显示什么名字；
我们在上一篇文章中用到的：
<label asp-for="Movie.Title" class="control-label"></label>这里就会显示Display属性指定的名字；
DataType属性标志这个字段是什么类型的；
上一章中我们说到的，数据类型的验证工作，就是依据这里标志的数据类型来完成的
比如你可以增加如下数据约束
[StringLength(60, MinimumLength = 3)]
[Required]
[Range(1, 100)]
[RegularExpression(@"^[A-Z]+[a-zA-Z''-'\s]*$")]
[DataType(DataType.Currency)]如果你想格式化输出的内容，你可以使用如下的属性注释
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}"]你可以在同一行代码中标记多个属性，如下：
[RegularExpression(@"^[A-Z]+[a-zA-Z''-'\s]*$"), Required, StringLength(30)]更多说明文档，可以查阅：https://docs.microsoft.com/zh-cn/aspnet/mvc/overview/older-versions/mvc-music-store/mvc-music-store-part-6
链接标签
在上一篇文章中我们简单说了一下链接标签，再来看第一章中提到的这个场景：
<a asp-page="./Edit" asp-route-id="@item.ID">Edit</a>
<a asp-page="./Details" asp-route-id="@item.ID">Details</a>
<a asp-page="./Delete" asp-route-id="@item.ID">Delete</a>asp-page和asp-route-id两个属性共同决定了最终编译出来的链接地址；
以前我们可能要拼字符串来构造href属性，现在不用了，可以分开写，代码更优雅；
上面的代码，编译后生成的href属性的值是这样的：
http://localhost:5000/Movies/Details?id=2
现在我们分别打开Edit.cshtml、Details.cshtml、Delete.cshtml
把页面中的第一个命令：@page，修改为：@page "{id:int}"
重新编译运行，发现上面的链接变成了：
http://localhost:5000/Movies/Details/1
看到这里你会说“呦~”吗？😄
如果这个时候你请求这个地址：
http://localhost:5000/Movies/Details
并没有传入ID的值，那么服务器会返回404，
如果你的设计是希望ID是一个可选的传入参数，那么你可以把page指令修改成：
@page "{id:int?}"这样就好啦！
如果你想让页面接收一个字符串，可以把这个“路由模版”写成如下这个样子：
@page "{searchString?}"并发数据异常
当一个用户删除了一个实体，另一个用户同时又要更新这个实体的话
第二个用户的请求就会抛出并发数据异常（这里姑且称作并发，微软官网就是这么说的），来看代码：
public async Task<IActionResult> OnPostAsync()
{
if (!ModelState.IsValid)
{
return Page();
}
_context.Attach(Movie).State = EntityState.Modified;
try
{
await _context.SaveChangesAsync();
}
catch (DbUpdateConcurrencyException)
{
if (!_context.Movie.Any(e => e.ID == Movie.ID))
{
return NotFound();
}
else
{
throw;
}
}
return RedirectToPage("./Index");
}上面代码中DbUpdateConcurrencyException就是专门针对这种异常定义的异常类；
NotFound方法将返回404异常
文件上传及读取
如果你想上传一个文件，可以撰写如下razor page的代码（只提供一部分表单域）
<div class="form-group">
<label asp-for="FileUpload.UploadPublicSchedule" class="control-label"></label>
<input asp-for="FileUpload.UploadPublicSchedule" type="file" class="form-control" style="height:auto" />
<span asp-validation-for="FileUpload.UploadPublicSchedule" class="text-danger"></span>
</div>这个表单域对应的实体如下
using Microsoft.AspNetCore.Http;
using System.ComponentModel.DataAnnotations;
namespace RazorPagesMovie.Models
{
public class FileUpload
{
[Required]
[Display(Name="Title")]
[StringLength(60, MinimumLength = 3)]
public string Title { get; set; }
[Required]
[Display(Name="Public Schedule")]
public IFormFile UploadPublicSchedule { get; set; }
}
}我们只要关注第二个字段即可，UploadPublicSchedule是一个IFormFile类型的字段；
当表单提交后，ASP.NET CORE 也会把文件流绑定到这个字段上；
如果上传的是一个文本文件，那么我们看看怎么直接读取这个文本文件；
public static async Task<string> ProcessFormFile(IFormFile formFile, ModelStateDictionary modelState)
{
var fieldDisplayName = string.Empty;
// 通过反射拿到实例的字段，再拿到字段的DisplayAttribute
MemberInfo property = typeof(FileUpload).GetProperty(formFile.Name.Substring(formFile.Name.IndexOf(".") + 1));
if (property != null)
{
var displayAttribute = property.GetCustomAttribute(typeof(DisplayAttribute)) as DisplayAttribute;
if (displayAttribute != null)
{
fieldDisplayName = $"{displayAttribute.Name} ";
}
}
// 通过Path.GetFileName拿到文件名
var fileName = WebUtility.HtmlEncode(Path.GetFileName(formFile.FileName));
if (formFile.ContentType.ToLower() != "text/plain")
{
modelState.AddModelError(formFile.Name, $"The {fieldDisplayName}file ({fileName}) must be a text file.");
}
// 判断文件长度
if (formFile.Length == 0)
{
modelState.AddModelError(formFile.Name, $"The {fieldDisplayName}file ({fileName}) is empty.");
}
else
{
try
{
string fileContents;
using (var reader = new StreamReader(formFile.OpenReadStream(), new UTF8Encoding(encoderShouldEmitUTF8Identifier: false, throwOnInvalidBytes: true), detectEncodingFromByteOrderMarks: true))
{
fileContents = await reader.ReadToEndAsync();
// 再验证一遍文件内容的长度，以防文件只有一个BOM头
if (fileContents.Length > 0)
{
return fileContents;
}
else
{
modelState.AddModelError(formFile.Name, $"The {fieldDisplayName}file ({fileName}) is empty.");
}
}
}
catch (IOException ex)
{
modelState.AddModelError(formFile.Name, $"The {fieldDisplayName}file ({fileName}) upload failed. Please contact the Help Desk for support.");
}
}
return string.Empty;
}调用上面方法的代码如下：
var publicScheduleData = await FileHelpers.ProcessFormFile(FileUpload.UploadPublicSchedule, ModelState);其中ModelState是PageModel特有的属性
在本示例中，用于给页面添加错误信息~
