Freigeben über

FileNameRouteConstraint Klasse

  • Referenz

Definition

Namespace:
Microsoft.AspNetCore.Routing.Constraints
Assembly:
Microsoft.AspNetCore.Routing.dll
Paket:
Microsoft.AspNetCore.App.Ref v3.0.1
Paket:
Microsoft.AspNetCore.App.Ref v3.1.10
Paket:
Microsoft.AspNetCore.App.Ref v5.0.0
Paket:
Microsoft.AspNetCore.App.Ref v6.0.6
Paket:
Microsoft.AspNetCore.App.Ref v7.0.5
Paket:
Microsoft.AspNetCore.App.Ref v8.0.0
Paket:
Microsoft.AspNetCore.App.Ref v9.0.0-rc.2.24474.3
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
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
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.

Gilt für: