NonFileNameRouteConstraint 類別

定義

命名空間:

Microsoft.AspNetCore.Routing.Constraints

組件:

Microsoft.AspNetCore.Routing.dll

套件:

Microsoft.AspNetCore.App.Ref v9.0.0

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

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

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

type NonFileNameRouteConstraint = class
    interface IRouteConstraint
    interface IParameterPolicy
    interface IParameterLiteralNodeMatchingPolicy

Public Class NonFileNameRouteConstraint
Implements IParameterLiteralNodeMatchingPolicy, IRouteConstraint

繼承

Object

NonFileNameRouteConstraint

實作

IParameterPolicy IRouteConstraint IParameterLiteralNodeMatchingPolicy

備註

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

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

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

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

路由值的範例，這些值會比對為非檔名-description

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

將拒絕為檔名-description 的路由值範例

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

建構函式

NonFileNameRouteConstraint()

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

方法

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

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

明確介面實作

IParameterLiteralNodeMatchingPolicy.MatchesLiteral(String, String)

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