FileNameRouteConstraint Classe

Définition

Espace de noms:

Microsoft.AspNetCore.Routing.Constraints

Assembly:

Microsoft.AspNetCore.Routing.dll

Paquet:

Microsoft.AspNetCore.App.Ref v8.0.0

Contraint un paramètre de route à représenter uniquement les valeurs de nom de fichier. Ne valide pas que la valeur de route contient des caractères de système de fichiers valides ou que la valeur représente un fichier réel sur le disque.

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

Héritage

Object

FileNameRouteConstraint

Implémente

IParameterPolicy IRouteConstraint IParameterLiteralNodeMatchingPolicy

Remarques

Cette contrainte peut être utilisée pour lever l’ambiguïté des demandes de fichiers statiques par rapport au contenu dynamique servi à partir de l’application.

Cette contrainte détermine si une valeur de route représente un nom de fichier en examinant le dernier segment chemin d’accès d’URL de la valeur (délimité par /). Le dernier segment doit contenir le caractère point (.) suivi d’un ou plusieurs caractères non-(.).

Si la valeur de route ne contient pas un / , la valeur entière sera interprétée comme le dernier segment.

FileNameRouteConstraint ne tente pas de vérifier que la valeur contient un nom de fichier légal pour le système d’exploitation actuel.

ne FileNameRouteConstraint tente pas de vérifier que la valeur représente un fichier réel sur le disque.

Exemples de valeurs de route qui seront mises en correspondance en tant que noms de fichiers-description

• /a/b/c.txt Le segment final contient un . suivi d’autres caractères.
• /hello.world.txt Le segment final contient un . suivi d’autres caractères.
• hello.world.txt Le segment final contient un . suivi d’autres caractères.
• .gitignore Le segment final contient un . suivi d’autres caractères.

Exemples de valeurs de route qui seront rejetées en tant que non-file-names-description

• /a/b/c Le segment final ne contient pas de ..
• /a/b.d/c Le segment final ne contient pas de ..
• /a/b.d/c/ Le segment final est vide.
• La valeur est vide

Constructeurs

FileNameRouteConstraint()

Contraint un paramètre de route à représenter uniquement les valeurs de nom de fichier. Ne valide pas que la valeur de route contient des caractères de système de fichiers valides ou que la valeur représente un fichier réel sur le disque.

Méthodes

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

Détermine si le paramètre d’URL contient une valeur valide pour cette contrainte.

Implémentations d’interfaces explicites

IParameterLiteralNodeMatchingPolicy.MatchesLiteral(String, String)

Contraint un paramètre de route à représenter uniquement les valeurs de nom de fichier. Ne valide pas que la valeur de route contient des caractères de système de fichiers valides ou que la valeur représente un fichier réel sur le disque.