FileNameRouteConstraint Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.AspNetCore.Routing.Constraints
Assembly:
Microsoft.AspNetCore.Routing.dll
Pacchetto:
Microsoft.AspNetCore.App.Ref v3.0.1
Pacchetto:
Microsoft.AspNetCore.App.Ref v3.1.10
Pacchetto:
Microsoft.AspNetCore.App.Ref v5.0.0
Pacchetto:
Microsoft.AspNetCore.App.Ref v6.0.6
Pacchetto:
Microsoft.AspNetCore.App.Ref v7.0.5
Pacchetto:
Microsoft.AspNetCore.App.Ref v8.0.0
Pacchetto:
Microsoft.AspNetCore.App.Ref v9.0.0-rc.2.24474.3
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
public class FileNameRouteConstraint : Microsoft.AspNetCore.Routing.IRouteConstraint, Microsoft.AspNetCore.Routing.Matching.IParameterLiteralNodeMatchingPolicy
type FileNameRouteConstraint = class
    interface IParameterPolicy
    interface IRouteConstraint
type FileNameRouteConstraint = class
    interface IRouteConstraint
    interface IParameterPolicy
type FileNameRouteConstraint = class
    interface IRouteConstraint
    interface IParameterPolicy
    interface IParameterLiteralNodeMatchingPolicy
Public Class FileNameRouteConstraint
Implements IRouteConstraint
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.

Si applica a