ControllerLinkGeneratorExtensions.GetUriByAction Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
| GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
public static string GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, object values, string scheme, Microsoft.AspNetCore.Http.HostString host, Microsoft.AspNetCore.Http.PathString pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions options = default);public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, object? values, string? scheme, Microsoft.AspNetCore.Http.HostString host, Microsoft.AspNetCore.Http.PathString pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions? options = default);public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, object? values, string scheme, Microsoft.AspNetCore.Http.HostString host, Microsoft.AspNetCore.Http.PathString pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions? options = default);static member GetUriByAction : Microsoft.AspNetCore.Routing.LinkGenerator * string * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string<Extension()>
Public Function GetUriByAction (generator As LinkGenerator, action As String, controller As String, values As Object, scheme As String, host As HostString, Optional pathBase As PathString = Nothing, Optional fragment As FragmentString = Nothing, Optional options As LinkOptions = Nothing) As StringParameter
- generator
- LinkGenerator
Die LinkGenerator.
- action
- String
Der Aktionsname. Wird zum Auflösen von Endpunkten verwendet.
- controller
- String
Der Controllername. Wird zum Auflösen von Endpunkten verwendet.
- values
- Object
Die Routenwerte. Ist möglicherweise NULL. Wird verwendet, um Endpunkte aufzulösen und Parameter in der Routenvorlage zu erweitern.
- scheme
- String
Das URI-Schema, das auf den resultierenden URI angewendet wird.
- host
- HostString
Der URI-Host/die -Autorität, die auf den resultierenden URI angewendet wird.
- pathBase
- PathString
Eine optionale URI-Pfadbasis. Dem Pfad im resultierenden URI vorangestellt.
- fragment
- FragmentString
Ein URI-Fragment. Optional. Wird an den resultierenden URI angefügt.
- options
- LinkOptions
Eine optionale LinkOptions-Klasse. Einstellungen für das bereitgestellte Objekt überschreiben die Einstellungen mit übereinstimmenden Namen von RouteOptions.
Gibt zurück
Ein absoluter URI oder null , wenn ein URI nicht erstellt werden kann.
Hinweise
Der Wert von host sollte ein vertrauenswürdiger Wert sein. Wenn Sie sich auf den Wert der aktuellen Anforderung verlassen, können nicht vertrauenswürdige Eingaben den resultierenden URI beeinflussen, es sei denn, der Host Header wurde überprüft. Anweisungen zum ordnungsgemäßen Überprüfen des Headers in Ihrer Bereitstellungsumgebung finden Sie in der Host Bereitstellungsdokumentation.
Gilt für:
GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
public static string GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string action = default, string controller = default, object values = default, string scheme = default, Microsoft.AspNetCore.Http.HostString? host = default, Microsoft.AspNetCore.Http.PathString? pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions options = default);public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? action = default, string? controller = default, object? values = default, string? scheme = default, Microsoft.AspNetCore.Http.HostString? host = default, Microsoft.AspNetCore.Http.PathString? pathBase = default, Microsoft.AspNetCore.Http.FragmentString fragment = default, Microsoft.AspNetCore.Routing.LinkOptions? options = default);static member GetUriByAction : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * string * obj * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string<Extension()>
Public Function GetUriByAction (generator As LinkGenerator, httpContext As HttpContext, Optional action As String = Nothing, Optional controller As String = Nothing, Optional values As Object = Nothing, Optional scheme As String = Nothing, Optional host As Nullable(Of HostString) = Nothing, Optional pathBase As Nullable(Of PathString) = Nothing, Optional fragment As FragmentString = Nothing, Optional options As LinkOptions = Nothing) As StringParameter
- generator
- LinkGenerator
Die LinkGenerator.
- httpContext
- HttpContext
Die HttpContext , die der aktuellen Anforderung zugeordnet ist.
- action
- String
Der Aktionsname. Wird zum Auflösen von Endpunkten verwendet. Optional. Wenn null angegeben, wird der aktuelle Wert der Aktionsroute verwendet.
- controller
- String
Der Controllername. Wird zum Auflösen von Endpunkten verwendet. Optional. Wenn null angegeben, wird der aktuelle Controllerroutenwert verwendet.
- values
- Object
Die Routenwerte. Optional. Wird verwendet, um Endpunkte aufzulösen und Parameter in der Routenvorlage zu erweitern.
- scheme
- String
Das URI-Schema, das auf den resultierenden URI angewendet wird. Optional. Wenn nicht angegeben, wird der Wert von Scheme verwendet.
- host
- Nullable<HostString>
Der URI-Host/die -Autorität, die auf den resultierenden URI angewendet wird. Optional. Falls nicht angegeben, wird der Wert Host verwendet.
- pathBase
- Nullable<PathString>
Eine optionale URI-Pfadbasis. Dem Pfad im resultierenden URI vorangestellt. Wenn nicht angegeben, wird der Wert von PathBase verwendet.
- fragment
- FragmentString
Ein URI-Fragment. Optional. Wird an den resultierenden URI angefügt.
- options
- LinkOptions
Eine optionale LinkOptions-Klasse. Einstellungen für das bereitgestellte Objekt überschreiben die Einstellungen mit übereinstimmenden Namen von RouteOptions.
Gibt zurück
Ein absoluter URI oder null , wenn ein URI nicht erstellt werden kann.
Hinweise
Der Wert von host sollte ein vertrauenswürdiger Wert sein. Wenn Sie sich auf den Wert der aktuellen Anforderung verlassen, können nicht vertrauenswürdige Eingaben den resultierenden URI beeinflussen, es sei denn, der Host Header wurde überprüft. Anweisungen zum ordnungsgemäßen Überprüfen des Headers in Ihrer Bereitstellungsumgebung finden Sie in der Host Bereitstellungsdokumentation.