官术网_书友最值得收藏!

Serving default documents

The frontend of modern web applications consists mostly of static files. Therefore, pointing the server to the client directory and instructing it to serve its entire content as static files is a common practice. In such situations, you will also want to send the user the main application file, such as index.html, when they navigate to the static folder. These files are called default documents.

Defining default documents for a static folder is done via the UseDefaultFiles method. Within the Startup.cs file, locate the Configure method and add the following marked line:

app.UseDefaultFiles();
app.UseStaticFiles();
UseDefaultFiles must be used before the UseStaticFiles call. If they are called in the opposite order, UseDefaultFiles will not have any affect.

The UseDefaultFiles method instructs ASP.NET Core to look for the following files once a URL that directs to a static folder has been detected:

  • default.htm
  • default.html
  • index.htm
  • index.html

These files will be looked for in that order. Once a filename matching one of these names is found, it will be served to the end user.

To change the filenames that UseDefaultFiles searches for, create and set a DefaultFilesOptions object and pass it to the method. For example, the following code changes the default filename collection to look for the main.htm and main.html files, instead of the predefined filenames:

DefaultFilesOptions options = new DefaultFilesOptions();
options.DefaultFileNames.Clear();
options.DefaultFileNames.Add("main.htm");
options.DefaultFileNames.Add("main.html");
app.UseDefaultFiles(options);

主站蜘蛛池模板: 会东县| 大港区| 水城县| 江油市| 喜德县| 胶州市| 石屏县| 无锡市| 宁乡县| 鄂州市| 财经| 南康市| 甘泉县| 延川县| 克什克腾旗| 合山市| 双牌县| 印江| 涞水县| 肥城市| 若羌县| 友谊县| 青冈县| 五华县| 敖汉旗| 卢龙县| 西青区| 鞍山市| 石渠县| 利津县| 丹东市| 稻城县| 江西省| 岳阳县| 筠连县| 遵义市| 阳新县| 牟定县| 长乐市| 方山县| 高邑县|