PageLinkGeneratorExtensions.GetUriByPage Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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);
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
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.
Dotyczy
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);
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
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.