Condividi tramite


PageLinkGeneratorExtensions.GetUriByPage Metodo

Definizione

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.

Si applica a