LinkGeneratorEndpointNameAddressExtensions.GetUriByName Metodo

Definizione

Spazio dei nomi:

Microsoft.AspNetCore.Routing

Assembly:

Microsoft.AspNetCore.Routing.dll

Pacchetto:

Microsoft.AspNetCore.App.Ref v9.0.0

Overload

GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)	Genera un URI assoluto in base ai valori specificati.
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)	Genera un URI assoluto in base ai valori specificati.
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Genera un URI assoluto in base ai valori specificati.
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Genera un URI assoluto in base ai valori specificati.

GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

Genera un URI assoluto in base ai valori specificati.

public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName As String, values As RouteValueDictionary, 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.

endpointName

String

Nome dell'endpoint. Usato per risolvere gli endpoint.

values

RouteValueDictionary

Valori della route. Usato per espandere i parametri nel modello di route.

scheme

String

Schema URI applicato all'URI risultante.

host

HostString

Host/autorità URI applicato all'URI risultante. Vedere la sezione osservazioni per informazioni dettagliate sulle implicazioni di sicurezza di host.

pathBase

PathString

Base del percorso URI facoltativo. Anteporre al percorso nell'URI risultante.

fragment

FragmentString

Frammento di URI facoltativo. 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

String

URI assoluto o null.

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.

GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

Genera un URI assoluto in base ai valori specificati.

public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName 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.

endpointName

String

Nome dell'endpoint. Usato per risolvere gli endpoint.

values

Object

Valori della route. Usato per espandere i parametri nel modello di route. Facoltativa.

scheme

String

Schema URI applicato all'URI risultante.

host

HostString

Host/autorità URI applicato all'URI risultante. Vedere la sezione osservazioni per informazioni dettagliate sulle implicazioni di sicurezza di host.

pathBase

PathString

Base del percorso URI facoltativo. Anteporre al percorso nell'URI risultante.

fragment

FragmentString

Frammento di URI facoltativo. 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

String

URI assoluto o null.

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.

GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Genera un URI assoluto in base ai valori specificati.

public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, Optional values As RouteValueDictionary = 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.

endpointName

String

Nome dell'endpoint. Usato per risolvere gli endpoint.

values

RouteValueDictionary

Valori della route. Usato per espandere i parametri nel modello di route. Facoltativa.

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 . Vedere la sezione osservazioni per informazioni dettagliate sulle implicazioni di sicurezza di 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 facoltativo. 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

String

URI con un percorso assoluto o null.

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.

GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Genera un URI assoluto in base ai valori specificati.

public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object? values, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, values As Object, 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.

endpointName

String

Nome dell'endpoint. Usato per risolvere gli endpoint.

values

Object

Valori della route. Usato per espandere i parametri nel modello di route. Facoltativa.

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 . Vedere la sezione osservazioni per informazioni dettagliate sulle implicazioni di sicurezza di 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 facoltativo. 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

String

URI con un percorso assoluto o null.

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.