LinkGeneratorEndpointNameAddressExtensions.GetUriByName Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.
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
Parametry
- generator
- LinkGenerator
Hodnota LinkGenerator
- endpointName
- String
Název koncového bodu. Používá se k překladu koncových bodů.
- values
- RouteValueDictionary
Hodnoty trasy. Slouží k rozbalení parametrů v šabloně trasy.
- scheme
- String
Schéma identifikátoru URI použité na výsledný identifikátor URI.
- host
- HostString
Hostitel/autorita URI, použitý na výsledný identifikátor URI.
Podrobnosti o dopadech na zabezpečení této funkce najdete v části s poznámkami host
.
- pathBase
- PathString
Volitelný základ cesty URI. Předsunuto k cestě ve výsledném identifikátoru URI.
- fragment
- FragmentString
Volitelný fragment identifikátoru URI. Připojí se k výslednému identifikátoru URI.
- options
- LinkOptions
Volitelný LinkOptionsobjekt . Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z .RouteOptions
Návraty
Absolutní identifikátor URI nebo null
.
Poznámky
Hodnota host
by měla být důvěryhodná hodnota. Spoléhání se na hodnotu aktuálního požadavku může umožnit nedůvěryhodnému vstupu ovlivnit výsledný identifikátor URI, pokud Host
není hlavička ověřena. Pokyny, jak správně ověřit hlavičku Host
v prostředí nasazení, najdete v dokumentaci k nasazení.
Platí pro
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.
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);
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
Parametry
- generator
- LinkGenerator
Hodnota LinkGenerator
- endpointName
- String
Název koncového bodu. Používá se k překladu koncových bodů.
- values
- Object
Hodnoty trasy. Slouží k rozbalení parametrů v šabloně trasy. Nepovinný parametr.
- scheme
- String
Schéma identifikátoru URI použité na výsledný identifikátor URI.
- host
- HostString
Hostitel/autorita URI, použitý na výsledný identifikátor URI.
Podrobnosti o dopadech na zabezpečení této funkce najdete v části s poznámkami host
.
- pathBase
- PathString
Volitelný základ cesty URI. Předsunuto k cestě ve výsledném identifikátoru URI.
- fragment
- FragmentString
Volitelný fragment identifikátoru URI. Připojí se k výslednému identifikátoru URI.
- options
- LinkOptions
Volitelný LinkOptionsobjekt . Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z .RouteOptions
Návraty
Absolutní identifikátor URI nebo null
.
Poznámky
Hodnota host
by měla být důvěryhodná hodnota. Spoléhání se na hodnotu aktuálního požadavku může umožnit nedůvěryhodnému vstupu ovlivnit výsledný identifikátor URI, pokud Host
není hlavička ověřena. Pokyny, jak správně ověřit hlavičku Host
v prostředí nasazení, najdete v dokumentaci k nasazení.
Platí pro
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.
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
Parametry
- generator
- LinkGenerator
Hodnota LinkGenerator
- httpContext
- HttpContext
Přidružená HttpContext k aktuální žádosti.
- endpointName
- String
Název koncového bodu. Používá se k překladu koncových bodů.
- values
- RouteValueDictionary
Hodnoty trasy. Slouží k rozbalení parametrů v šabloně trasy. Nepovinný parametr.
- scheme
- String
Schéma identifikátoru URI použité na výsledný identifikátor URI. Nepovinný parametr. Pokud ji nezadáte, použije se hodnota Scheme .
- host
- Nullable<HostString>
Hostitel/autorita URI, použitý na výsledný identifikátor URI. Nepovinný parametr. Pokud ji nezadáte, použije se hodnota Host .
Podrobnosti o dopadech na zabezpečení této funkce najdete v části s poznámkami host
.
- pathBase
- Nullable<PathString>
Volitelný základ cesty URI. Předsunuto k cestě ve výsledném identifikátoru URI. Pokud ji nezadáte, použije se hodnota PathBase .
- fragment
- FragmentString
Volitelný fragment identifikátoru URI. Připojí se k výslednému identifikátoru URI.
- options
- LinkOptions
Volitelný LinkOptionsobjekt . Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z .RouteOptions
Návraty
Identifikátor URI s absolutní cestou nebo null
.
Poznámky
Hodnota host
by měla být důvěryhodná hodnota. Spoléhání se na hodnotu aktuálního požadavku může umožnit nedůvěryhodnému vstupu ovlivnit výsledný identifikátor URI, pokud Host
není hlavička ověřena. Pokyny, jak správně ověřit hlavičku Host
v prostředí nasazení, najdete v dokumentaci k nasazení.
Platí pro
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.
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);
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
Parametry
- generator
- LinkGenerator
Hodnota LinkGenerator
- httpContext
- HttpContext
Přidružená HttpContext k aktuální žádosti.
- endpointName
- String
Název koncového bodu. Používá se k překladu koncových bodů.
- values
- Object
Hodnoty trasy. Slouží k rozbalení parametrů v šabloně trasy. Nepovinný parametr.
- scheme
- String
Schéma identifikátoru URI použité na výsledný identifikátor URI. Nepovinný parametr. Pokud ji nezadáte, použije se hodnota Scheme .
- host
- Nullable<HostString>
Hostitel/autorita URI, použitý na výsledný identifikátor URI. Nepovinný parametr. Pokud ji nezadáte, použije se hodnota Host .
Podrobnosti o dopadech na zabezpečení této funkce najdete v části s poznámkami host
.
- pathBase
- Nullable<PathString>
Volitelný základ cesty URI. Předsunuto k cestě ve výsledném identifikátoru URI. Pokud ji nezadáte, použije se hodnota PathBase .
- fragment
- FragmentString
Volitelný fragment identifikátoru URI. Připojí se k výslednému identifikátoru URI.
- options
- LinkOptions
Volitelný LinkOptionsobjekt . Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z .RouteOptions
Návraty
Identifikátor URI s absolutní cestou nebo null
.
Poznámky
Hodnota host
by měla být důvěryhodná hodnota. Spoléhání se na hodnotu aktuálního požadavku může umožnit nedůvěryhodnému vstupu ovlivnit výsledný identifikátor URI, pokud Host
není hlavička ověřena. Pokyny, jak správně ověřit hlavičku Host
v prostředí nasazení, najdete v dokumentaci k nasazení.