doc(CardUpload): update documation (#4373)

* doc: 更新示例上传文件限制更改为 5M

* feat: 增加 AutoResetWhenInvalid 参数

* doc: 代码格式化

* Revert "feat: 增加 AutoResetWhenInvalid 参数"

This reverts commit 8798549.

* chore: bump version 8.10.1

src/BootstrapBlazor.Server/Components/Samples/Uploads.razor.cs

@@ -21,7 +21,7 @@ public sealed partial class Uploads
 
  private CancellationTokenSource? ReadToken { get; set; }
 
- private static long MaxFileLength => 200 * 1024 * 1024;
+ private static long MaxFileLength => 5 * 1024 * 1024;
 
  private Person Foo1 { get; set; } = new Person();
 
@@ -184,7 +184,7 @@ private async Task OnCardUpload(UploadFile file)
  {
  if (file != null && file.File != null)
  {
- // 服务器端验证当文件大于 2MB 时提示文件太大信息
+ // 服务器端验证当文件大于 5MB 时提示文件太大信息
  if (file.Size > MaxFileLength)
  {
  await ToastService.Information(Localizer["UploadsFileMsg"], Localizer["UploadsFileError"]);

src/BootstrapBlazor.Server/Locales/en-US.json

@@ -3387,7 +3387,7 @@
  "UploadPreCardStyleWasm": "<b>Wasm mode </b>",
  "UploadPreCardStyleWasmSide": "It wasn't available in <code>wasm</code> mode, <code>IWebHostEnvironment</code> needed to save files to the server side by calling <code>webapi</code> interface, and so on",
  "UploadPreCardStyleLink": "Interested students can view their knowledge of <code>Upload</code> components through the <code>wiki</code> in the open source repository related resources of the <a href='{0}' target='_blank'>[The portal]</a>",
- "UploadPreCardStyleValidation": "In this example, server-side verification prompts the file for too much prompt when the file size exceeds <code>200MB</code>",
+ "UploadPreCardStyleValidation": "In this example, server-side verification prompts the file for too much prompt when the file size exceeds <code>5MB</code>",
  "UploadPreCardStyleTips1": "In this example, the <code>ShowProgress=true</code> display upload progress bar",
  "UploadPreCardStyleTips2": "When you set up <code>IsSingle</code>, you can upload only one image or file",
  "UploadFileIconTitle": "The file icon",
@@ -3425,7 +3425,7 @@
  "UploadsFormatError": "The file format is incorrect",
  "UploadsAvatarMsg": "Avatar upload",
  "UploadsFileMsg": "Upload the file",
- "UploadsFileError": "The file size is greater than 200MB",
+ "UploadsFileError": "The file size is greater than 5MB",
  "UploadsSaveFileError": "Failed to save the file",
  "UploadFile": "Upload the file",
  "UploadsWasmError": "Wasm mode does not implement saving code",

src/BootstrapBlazor.Server/Locales/zh-CN.json

@@ -3387,7 +3387,7 @@
  "UploadPreCardStyleWasm": "<b>Wasm 模式</b>",
  "UploadPreCardStyleWasmSide": "<code>wasm</code> 模式中无法使用 <code>IWebHostEnvironment</code> 需要调用 <code>webapi</code> 接口等形式将文件保存到服务器端",
  "UploadPreCardStyleLink": "有兴趣的同学可以通过开源仓库中的 <code>wiki</code> 文档中相关资源查看关于 <code>Upload</code> 组件的相关知识技巧 <a href='{0}' target='_blank'>[传送门]</a>",
- "UploadPreCardStyleValidation": "本例中通过服务器端验证当文件大小超过 <code>200MB</code> 时，提示文件太大提示信息",
+ "UploadPreCardStyleValidation": "本例中通过服务器端验证当文件大小超过 <code>5MB</code> 时，提示文件太大提示信息",
  "UploadPreCardStyleTips1": "本例中设置 <code>ShowProgress=true</code> 显示上传进度条",
  "UploadPreCardStyleTips2": "设置 <code>IsSingle</code> 时，仅可以上传一张图片或者文件",
  "UploadFileIconTitle": "文件图标",
@@ -3425,7 +3425,7 @@
  "UploadsFormatError": "文件格式不正确",
  "UploadsAvatarMsg": "头像上传",
  "UploadsFileMsg": "上传文件",
- "UploadsFileError": "文件大小超过 200MB",
+ "UploadsFileError": "文件大小超过 5MB",
  "UploadsSaveFileError": "保存文件失败",
  "UploadFile": "上传文件",
  "UploadsWasmError": "Wasm 模式未实现保存代码",

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
  <PropertyGroup>
- <Version>8.9.4</Version>
+ <Version>8.10.1</Version>
  </PropertyGroup>
 
  <ItemGroup Condition="'$(TargetFramework)' == 'net6.0'">

src/BootstrapBlazor/Components/Upload/ButtonUploadBase.cs

@@ -214,7 +214,8 @@ protected override async Task OnFileChange(InputFileChangeEventArgs args)
  }
  file.Uploaded = true;
  }
- //触发ValueChange，以支持bing-value
+
+ //触发 ValueChange，以支持 bind-value
  await base.OnFileChange(args);
  }
 

src/BootstrapBlazor/Components/Upload/UploadBase.cs

@@ -102,7 +102,7 @@ protected virtual async Task<bool> OnFileDelete(UploadFile item)
  }
 
  /// <summary>
- /// 
+ /// 上传文件改变时回调此方法
  /// </summary>
  /// <param name="args"></param>
  /// <returns></returns>