ControllerLinkGeneratorExtensions.GetUriByAction Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Genera un URI assoluto in base ai valori specificati. |
| GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Genera un URI assoluto in base ai valori specificati. |
GetUriByAction(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Genera un URI assoluto in base ai valori specificati.
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 StringParametri
- generator
- LinkGenerator
Oggetto LinkGenerator.
- action
- String
Nome dell'azione. Usato per risolvere gli endpoint.
- controller
- String
Nome del controller. Usato per risolvere gli endpoint.
- values
- Object
Valori della route. Può essere Null. Usato per risolvere gli endpoint ed espandere i parametri nel modello di route.
- scheme
- String
Schema URI applicato all'URI risultante.
- host
- HostString
Host/autorità URI applicato all'URI risultante.
- pathBase
- PathString
Base del percorso URI facoltativo. Anteporre al percorso nell'URI risultante.
- fragment
- FragmentString
Frammento di URI. Facoltativa. Aggiunto all'URI risultante.
- options
- LinkOptions
Oggetto LinkOptions facoltativo. Le impostazioni sull'oggetto specificato eseguono l'override delle impostazioni con nomi corrispondenti da RouteOptions.
Restituisce
URI assoluto o null se non è possibile creare un URI.
Commenti
Il valore di host deve essere un valore attendibile. Basandosi sul valore della richiesta corrente, è possibile consentire all'input non attendibile di influenzare l'URI risultante, a meno che l'intestazione Host non sia stata convalidata. Per istruzioni su come convalidare correttamente l'intestazione nell'ambiente Host di distribuzione, vedere la documentazione sulla distribuzione.
Si applica a
GetUriByAction(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Genera un URI assoluto in base ai valori specificati.
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 StringParametri
- generator
- LinkGenerator
Oggetto LinkGenerator.
- httpContext
- HttpContext
Oggetto HttpContext associato alla richiesta corrente.
- action
- String
Nome dell'azione. Usato per risolvere gli endpoint. Facoltativa. Se null viene specificato, verrà usato il valore di route dell'azione corrente.
- controller
- String
Nome del controller. Usato per risolvere gli endpoint. Facoltativa. Se null viene specificato, verrà usato il valore di route del controller corrente.
- values
- Object
Valori della route. Facoltativa. Usato per risolvere gli endpoint ed espandere i parametri nel modello di route.
- scheme
- String
Schema URI applicato all'URI risultante. Facoltativa. Se non specificato, verrà utilizzato il valore di Scheme .
- host
- Nullable<HostString>
Host/autorità URI applicato all'URI risultante. Facoltativa. Se non specificato, verrà usato il valore Host .
- pathBase
- Nullable<PathString>
Base del percorso URI facoltativo. Anteporre al percorso nell'URI risultante. Se non specificato, verrà utilizzato il valore di PathBase .
- fragment
- FragmentString
Frammento di URI. Facoltativa. Aggiunto all'URI risultante.
- options
- LinkOptions
Oggetto LinkOptions facoltativo. Le impostazioni sull'oggetto specificato eseguono l'override delle impostazioni con nomi corrispondenti da RouteOptions.
Restituisce
URI assoluto o null se non è possibile creare un URI.
Commenti
Il valore di host deve essere un valore attendibile. Basandosi sul valore della richiesta corrente, è possibile consentire all'input non attendibile di influenzare l'URI risultante, a meno che l'intestazione Host non sia stata convalidata. Per istruzioni su come convalidare correttamente l'intestazione nell'ambiente Host di distribuzione, vedere la documentazione sulla distribuzione.