FileNameRouteConstraint Klasse

Definition

Namespace:

Microsoft.AspNetCore.Routing.Constraints

Assembly:

Microsoft.AspNetCore.Routing.dll

Paket:

Microsoft.AspNetCore.App.Ref v8.0.0

Quelle:

FileNameRouteConstraint.cs

Schränkt einen Routenparameter so ein, dass er nur Dateinamenwerte darstellt. Überprüft nicht, ob der Routenwert gültige Dateisystemzeichen enthält oder ob der Wert eine tatsächliche Datei auf dem Datenträger darstellt.

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

Vererbung

Object

FileNameRouteConstraint

Implementiert

IParameterPolicy IRouteConstraint IParameterLiteralNodeMatchingPolicy

Hinweise

Diese Einschränkung kann verwendet werden, um Anforderungen für statische Dateien im Vergleich zu dynamischen Inhalten, die von der Anwendung bereitgestellt werden, zu unterscheiden.

Diese Einschränkung bestimmt, ob ein Routenwert einen Dateinamen darstellt, indem das letzte URL-Pfadsegment des -Werts (durch trennzeichen) untersucht wird /. Das letzte Segment muss den Punkt (.) gefolgt von einem oder mehreren Nicht()-.Zeichen enthalten.

Wenn der Routenwert kein enthält / , wird der gesamte Wert als letztes Segment interpretiert.

Versucht FileNameRouteConstraint nicht zu überprüfen, ob der Wert einen rechtlichen Dateinamen für das aktuelle Betriebssystem enthält.

Versucht FileNameRouteConstraint nicht zu überprüfen, ob der Wert eine tatsächliche Datei auf dem Datenträger darstellt.

Beispiele für Routenwerte, die als Dateinamenbeschreibung abgeglichen werden

• /a/b/c.txt : Das letzte Segment enthält ein . gefolgt von anderen Zeichen.
• /hello.world.txt : Das letzte Segment enthält ein . gefolgt von anderen Zeichen.
• hello.world.txt : Das letzte Segment enthält ein . gefolgt von anderen Zeichen.
• .gitignore : Das letzte Segment enthält ein . gefolgt von anderen Zeichen.

Beispiele für Routenwerte, die als Nicht-Dateinamen-description abgelehnt werden

• /a/b/c : Das endgültige Segment enthält .keine .
• /a/b.d/c : Das endgültige Segment enthält .keine .
• /a/b.d/c/ : Das letzte Segment ist leer.
• : Der Wert ist leer.

Konstruktoren

FileNameRouteConstraint()

Schränkt einen Routenparameter so ein, dass er nur Dateinamenwerte darstellt. Überprüft nicht, ob der Routenwert gültige Dateisystemzeichen enthält oder ob der Wert eine tatsächliche Datei auf dem Datenträger darstellt.

Methoden

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

Bestimmt, ob der URL-Parameter einen gültigen Wert für diese Einschränkung enthält.

Explizite Schnittstellenimplementierungen

IParameterLiteralNodeMatchingPolicy.MatchesLiteral(String, String)

Schränkt einen Routenparameter so ein, dass er nur Dateinamenwerte darstellt. Überprüft nicht, ob der Routenwert gültige Dateisystemzeichen enthält oder ob der Wert eine tatsächliche Datei auf dem Datenträger darstellt.