PageLinkGeneratorExtensions.GetUriByPage Metoda

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Routing

Zestaw:

Microsoft.AspNetCore.Mvc.Core.dll

Pakiet:

Microsoft.AspNetCore.App.Ref v8.0.0

Przeciążenia

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)	Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

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

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

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

Element LinkGenerator.

page

String

Nazwa strony. Służy do rozpoznawania punktów końcowych.

handler

String

Nazwa programu obsługi stron. Może mieć wartość null.

values

Object

Wartości trasy. Może mieć wartość null. Służy do rozpoznawania punktów końcowych i rozwijania parametrów w szablonie trasy.

scheme

String

Schemat identyfikatora URI zastosowany do wynikowego identyfikatora URI.

host

HostString

Host/urząd identyfikatora URI zastosowany do wynikowego identyfikatora URI.

pathBase

PathString

Opcjonalna baza ścieżki identyfikatora URI. Prepended do ścieżki w wynikowym identyfikatorze URI.

fragment

FragmentString

Fragment identyfikatora URI. Opcjonalny. Dołączono do wynikowego identyfikatora URI.

options

LinkOptions

Opcjonalny LinkOptionselement . Ustawienia podanego obiektu zastępują ustawienia pasującymi nazwami z RouteOptions.

Zwraca

String

Bezwzględny identyfikator URI lub null jeśli nie można utworzyć identyfikatora URI.

Uwagi

Wartość host powinna być zaufaną wartością. Poleganie na wartości bieżącego żądania może zezwalać niezaufanym wejściom na wpływ na wynikowy identyfikator URI, chyba że Host nagłówek został zweryfikowany. Zapoznaj się z dokumentacją wdrażania, aby uzyskać instrukcje dotyczące prawidłowego weryfikowania nagłówka Host w środowisku wdrażania.

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

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

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

Element LinkGenerator.

httpContext

HttpContext

Skojarzone HttpContext z bieżącym żądaniem.

page

String

Nazwa strony. Służy do rozpoznawania punktów końcowych. Opcjonalny. Jeśli null zostanie podana, zostanie użyta bieżąca wartość trasy strony.

handler

String

Nazwa programu obsługi stron. Służy do rozpoznawania punktów końcowych. Opcjonalny.

values

Object

Wartości trasy. Opcjonalny. Służy do rozpoznawania punktów końcowych i rozwijania parametrów w szablonie trasy.

scheme

String

Schemat identyfikatora URI zastosowany do wynikowego identyfikatora URI. Opcjonalny. Jeśli nie zostanie podana, zostanie użyta Scheme wartość .

host

Nullable<HostString>

Host/urząd identyfikatora URI zastosowany do wynikowego identyfikatora URI. Opcjonalny. Jeśli nie zostanie podana, zostanie użyta wartość Host .

pathBase

Nullable<PathString>

Opcjonalna baza ścieżki identyfikatora URI. Prepended do ścieżki w wynikowym identyfikatorze URI. Jeśli nie zostanie podana, zostanie użyta PathBase wartość .

fragment

FragmentString

Fragment identyfikatora URI. Opcjonalny. Dołączono do wynikowego identyfikatora URI.

options

LinkOptions

Opcjonalny LinkOptionselement . Ustawienia podanego obiektu zastępują ustawienia pasującymi nazwami z RouteOptions.

Zwraca

String

Bezwzględny identyfikator URI lub null jeśli nie można utworzyć identyfikatora URI.

Uwagi

Wartość host powinna być zaufaną wartością. Poleganie na wartości bieżącego żądania może zezwalać niezaufanym wejściom na wpływ na wynikowy identyfikator URI, chyba że Host nagłówek został zweryfikowany. Zapoznaj się z dokumentacją wdrażania, aby uzyskać instrukcje dotyczące prawidłowego weryfikowania nagłówka Host w środowisku wdrażania.