FileNameRouteConstraint Classe

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Routing.Constraints

Assembly:

Microsoft.AspNetCore.Routing.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v8.0.0

Origine:

FileNameRouteConstraint.cs

Vincola un parametro di route per rappresentare solo i valori del nome file. Non verifica che il valore di route contenga caratteri di file system validi o che il valore rappresenti un file effettivo su disco.

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

Ereditarietà

Object

FileNameRouteConstraint

Implementazioni

IParameterPolicy IRouteConstraint IParameterLiteralNodeMatchingPolicy

Commenti

Questo vincolo può essere usato per evitare ambiguità tra le richieste per i file statici e il contenuto dinamico servito dall'applicazione.

Questo vincolo determina se un valore di route rappresenta un nome file esaminando l'ultimo segmento percorso URL del valore (delimitato da /). L'ultimo segmento deve contenere il carattere punto (.) seguito da uno o più caratteri non(.).

Se il valore della route non contiene un oggetto / , l'intero valore verrà interpretato come l'ultimo segmento.

Non FileNameRouteConstraint tenta di convalidare che il valore contenga un nome di file valido per il sistema operativo corrente.

Non FileNameRouteConstraint tenta di convalidare che il valore rappresenta un file effettivo su disco.

Esempi di valori di route che verranno confrontati come nomi di file- descrizione

• /a/b/c.txt : il segmento finale contiene un . oggetto seguito da altri caratteri.
• /hello.world.txt : il segmento finale contiene un . oggetto seguito da altri caratteri.
• hello.world.txt : il segmento finale contiene un . oggetto seguito da altri caratteri.
• .gitignore : il segmento finale contiene un . oggetto seguito da altri caratteri.

Esempi di valori di route che verranno rifiutati come non-file-names-description

• /a/b/c : il segmento finale non contiene un oggetto ..
• /a/b.d/c : il segmento finale non contiene un oggetto ..
• /a/b.d/c/ : il segmento finale è vuoto.
• : il valore è vuoto

Costruttori

FileNameRouteConstraint()

Vincola un parametro di route per rappresentare solo i valori del nome file. Non verifica che il valore di route contenga caratteri di file system validi o che il valore rappresenti un file effettivo su disco.

Metodi

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

Determina se il parametro URL contiene un valore valido per questo vincolo.

Implementazioni dell'interfaccia esplicita

IParameterLiteralNodeMatchingPolicy.MatchesLiteral(String, String)

Vincola un parametro di route per rappresentare solo i valori del nome file. Non verifica che il valore di route contenga caratteri di file system validi o che il valore rappresenti un file effettivo su disco.