FileNameRouteConstraint 類別

定義

命名空間:

Microsoft.AspNetCore.Routing.Constraints

組件:

Microsoft.AspNetCore.Routing.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

限制路由參數只代表檔案名值。 不會驗證路由值是否包含有效的檔案系統字元，或該值代表磁片上的實際檔案。

public ref class FileNameRouteConstraint : Microsoft::AspNetCore::Routing::IRouteConstraint

public class FileNameRouteConstraint : Microsoft.AspNetCore.Routing.IRouteConstraint, Microsoft.AspNetCore.Routing.Matching.IParameterLiteralNodeMatchingPolicy

type FileNameRouteConstraint = class
    interface IRouteConstraint
    interface IParameterPolicy
    interface IParameterLiteralNodeMatchingPolicy

Public Class FileNameRouteConstraint
Implements IParameterLiteralNodeMatchingPolicy, IRouteConstraint

繼承

Object

FileNameRouteConstraint

實作

IParameterPolicy IRouteConstraint IParameterLiteralNodeMatchingPolicy

備註

此條件約束可用來厘清靜態檔案的要求與從應用程式提供的動態內容。

此條件約束會檢查值的最後一個 URL 路徑區段，以) 分隔 / (的值，來判斷路由值是否代表檔案名。 最後一個線段必須包含點 (.) 字元，後面接著一或多個非 (.) 字元。

如果路由值不包含 / ，則會將整個值解譯為最後一個區段。

FileNameRouteConstraint不會嘗試驗證值是否包含目前作業系統的法律檔案名。

FileNameRouteConstraint不會嘗試驗證值是否代表磁片上的實際檔案。

路由值的範例，這些值會以檔案名描述進行比對

• /a/b/c.txt 最後一個區段包含 . 後面接著其他字元。
• /hello.world.txt 最後一個區段包含 . 後面接著其他字元。
• hello.world.txt 最後一個區段包含 . 後面接著其他字元。
• .gitignore 最後一個區段包含 . 後面接著其他字元。

將拒絕為非檔案名描述之路由值的範例

• /a/b/c 最終區段不包含 . 。
• /a/b.d/c 最終區段不包含 . 。
• /a/b.d/c/ 最後一個區段是空的。
• 值是空的

建構函式

FileNameRouteConstraint()

限制路由參數只代表檔案名值。 不會驗證路由值是否包含有效的檔案系統字元，或該值代表磁片上的實際檔案。

方法

Match(HttpContext, IRouter, String, RouteValueDictionary, RouteDirection)

判斷 URL 參數是否包含對這個條件約束有效的值。

明確介面實作

IParameterLiteralNodeMatchingPolicy.MatchesLiteral(String, String)

限制路由參數只代表檔案名值。 不會驗證路由值是否包含有效的檔案系統字元，或該值代表磁片上的實際檔案。