前文索引:
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特有的属性

在本示例中,用于给页面添加错误信息~