LinkGenerator.GetUriByAddress Metoda

  • Reference

Definice

Obor názvů:
Microsoft.AspNetCore.Routing
Sestavení:
Microsoft.AspNetCore.Routing.Abstractions.dll
Balíček:
Microsoft.AspNetCore.Routing.Abstractions v2.2.0
Balíček:
Microsoft.AspNetCore.App.Ref v3.0.1
Balíček:
Microsoft.AspNetCore.App.Ref v3.1.10
Balíček:
Microsoft.AspNetCore.App.Ref v5.0.0
Balíček:
Microsoft.AspNetCore.App.Ref v6.0.6
Balíček:
Microsoft.AspNetCore.App.Ref v7.0.5
Balíček:
Microsoft.AspNetCore.App.Ref v8.0.0
Balíček:
Microsoft.AspNetCore.App.Ref v9.0.0-rc.2.24474.3

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)

Zdroj:
LinkGenerator.cs

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);
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);
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í.

Platí pro

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

Zdroj:
LinkGenerator.cs

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);
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í.

Platí pro