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

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

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

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

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

page

String

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

handler

String

Název obslužné rutiny stránky. Může mít hodnotu null.

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

GetUriByPage(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? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = 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 GetUriByPage : 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler 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.

page

String

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

handler

String

Název obslužné rutiny stránky. Používá se k překladu koncových bodů. Nepovinný parametr.

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