PageLinkGeneratorExtensions.GetUriByPage 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
GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Genera un URI assoluto in base ai valori specificati. |
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Genera un URI assoluto in base ai valori specificati. |
GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
- Origine:
- PageLinkGeneratorExtensions.cs
- Origine:
- PageLinkGeneratorExtensions.cs
Genera un URI assoluto in base ai valori specificati.
public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string handler, 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? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, 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 GetUriByPage : 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 GetUriByPage (generator As LinkGenerator, page As String, handler 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 String
Parametri
- generator
- LinkGenerator
Oggetto LinkGenerator.
- page
- String
Nome della pagina. Usato per risolvere gli endpoint.
- handler
- String
Nome del gestore di pagina. Può essere Null.
- 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
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Origine:
- PageLinkGeneratorExtensions.cs
- Origine:
- PageLinkGeneratorExtensions.cs
Genera un URI assoluto in base ai valori specificati.
public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string page = default, string handler = 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? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = 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 GetUriByPage : 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler 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 String
Parametri
- generator
- LinkGenerator
Oggetto LinkGenerator.
- httpContext
- HttpContext
Oggetto HttpContext associato alla richiesta corrente.
- page
- String
Nome della pagina. Usato per risolvere gli endpoint. Facoltativa. Se null
viene specificato, verrà usato il valore di route della pagina corrente.
- handler
- String
Nome del gestore di pagina. Usato per risolvere gli endpoint. Facoltativa.
- 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.