LinkGenerator.GetUriByAddress Metoda

Definice

Obor názvů:

Microsoft.AspNetCore.Routing

Sestavení:

Microsoft.AspNetCore.Routing.Abstractions.dll

Balíček:

Microsoft.AspNetCore.App.Ref v9.0.0

Přetížení

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)	Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.
GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Vygeneruje absolutní identifikátor URI na základě zadaných hodnot a HttpContext.

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

Vygeneruje absolutní identifikátor URI na základě zadaných hodnot.

public abstract string? GetUriByAddress<TAddress> (TAddress address, 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);

abstract member GetUriByAddress : 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

Public MustOverride Function GetUriByAddress(Of TAddress) (address As TAddress, 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 typu

TAddress

Typ adresy.

Parametry

address

TAddress

Hodnota adresy. Používá se k řešení problémů s koncovými body.

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 identifikátoru URI použitá pro 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ředpřidá se 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ý objekt LinkOptions. Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z RouteOptions.

Návraty

String

Absolutní identifikátor URI nebo null.

Poznámky

Hodnota host by měla být důvěryhodná. Spoléhání 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í.

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Vygeneruje absolutní identifikátor URI na základě zadaných hodnot a HttpContext.

public abstract string? GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary? ambientValues = 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);

abstract member GetUriByAddress : Microsoft.AspNetCore.Http.HttpContext * 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

Public MustOverride Function GetUriByAddress(Of TAddress) (httpContext As HttpContext, address As TAddress, values As RouteValueDictionary, Optional ambientValues 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 typu

TAddress

Typ adresy.

Parametry

httpContext

HttpContext

Přidružený HttpContext k aktuálnímu požadavku.

address

TAddress

Hodnota adresy. Používá se k řešení problémů s koncovými body.

values

RouteValueDictionary

Hodnoty trasy. Slouží k rozbalení parametrů v šabloně trasy.

ambientValues

RouteValueDictionary

Hodnoty přidružené k aktuálnímu požadavku. 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 identifikátoru URI použitá pro výsledný identifikátor URI. Nepovinný parametr. Pokud hodnotu nezadáte, Host použije se. 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ředpřidá se 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ý objekt LinkOptions. Nastavení u zadaného objektu přepíší nastavení odpovídajícími názvy z RouteOptions.

Návraty

String

Identifikátor URI s absolutní cestou nebo null.

Poznámky

Hodnota host by měla být důvěryhodná. Spoléhání 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í.