ControllerLinkGeneratorExtensions.GetUriByAction Metoda

Definice

Obor názvů:

Microsoft.AspNetCore.Routing

Sestavení:

Microsoft.AspNetCore.Mvc.Core.dll

Balíček:

Microsoft.AspNetCore.App.Ref v8.0.0

Přetížení

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

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

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

public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, action As String, controller 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

action

String

Název akce. Používá se k překladu koncových bodů.

controller

String

Název kontroleru. Používá se k překladu koncových bodů.

values

Object

Hodnoty trasy. Může mít hodnotu null. Slouží k překladu koncových bodů a 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.

pathBase

PathString

Volitelný základ cesty URI. Předsunuto k cestě ve výsledném identifikátoru URI.

fragment

FragmentString

Fragment identifikátoru URI. Nepovinný parametr. 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

String

Absolutní identifikátor URI nebo null pokud identifikátor URI nelze vytvořit.

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

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

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

public static string? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? action = default, string? controller = 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, httpContext As HttpContext, Optional action As String = Nothing, Optional controller 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

Parametry

generator

LinkGenerator

Hodnota LinkGenerator

httpContext

HttpContext

Přidružená HttpContext k aktuální žádosti.

action

String

Název akce. Používá se k překladu koncových bodů. Nepovinný parametr. Pokud null je k dispozici, použije se aktuální hodnota trasy akce.

controller

String

Název kontroleru. Používá se k překladu koncových bodů. Nepovinný parametr. Pokud null je k dispozici, použije se aktuální hodnota trasy kontroleru.

values

Object

Hodnoty trasy. Nepovinný parametr. Slouží k překladu koncových bodů a rozbalení parametrů v šabloně trasy.

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 .

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

Fragment identifikátoru URI. Nepovinný parametr. 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

String

Absolutní identifikátor URI nebo null pokud identifikátor URI nelze vytvořit.

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