LinkGeneratorEndpointNameAddressExtensions.GetUriByName 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
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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);
static member GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName As String, 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
- generator
- LinkGenerator
Element LinkGenerator.
- endpointName
- String
Nazwa punktu końcowego. Służy do rozpoznawania punktów końcowych.
- values
- RouteValueDictionary
Wartości trasy. Służy do 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.
Zobacz sekcję uwagi, aby uzyskać szczegółowe informacje o implikacjach związanych z zabezpieczeniami elementu host
.
- pathBase
- PathString
Opcjonalna baza ścieżki identyfikatora URI. Prepended do ścieżki w wynikowym identyfikatorze URI.
- fragment
- FragmentString
Opcjonalny fragment identyfikatora URI. 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
.
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
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName 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.
- endpointName
- String
Nazwa punktu końcowego. Służy do rozpoznawania punktów końcowych.
- values
- Object
Wartości trasy. Służy do rozwijania parametrów w szablonie trasy. Opcjonalny.
- scheme
- String
Schemat identyfikatora URI zastosowany do wynikowego identyfikatora URI.
- host
- HostString
Host/urząd identyfikatora URI zastosowany do wynikowego identyfikatora URI.
Zobacz sekcję uwagi, aby uzyskać szczegółowe informacje o implikacjach związanych z zabezpieczeniami elementu host
.
- pathBase
- PathString
Opcjonalna baza ścieżki identyfikatora URI. Prepended do ścieżki w wynikowym identyfikatorze URI.
- fragment
- FragmentString
Opcjonalny fragment identyfikatora URI. 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
.
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
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, Optional values 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
- generator
- LinkGenerator
Element LinkGenerator.
- httpContext
- HttpContext
Skojarzone HttpContext z bieżącym żądaniem.
- endpointName
- String
Nazwa punktu końcowego. Służy do rozpoznawania punktów końcowych.
- values
- RouteValueDictionary
Wartości trasy. Służy do rozwijania parametrów w szablonie trasy. Opcjonalny.
- 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 .
Zobacz sekcję uwagi, aby uzyskać szczegółowe informacje o implikacjach związanych z zabezpieczeniami elementu 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
Opcjonalny fragment identyfikatora URI. Dołączono do wynikowego identyfikatora URI.
- options
- LinkOptions
Opcjonalny LinkOptionselement . Ustawienia podanego obiektu zastępują ustawienia pasującymi nazwami z RouteOptions
.
Zwraca
Identyfikator URI ze ścieżką bezwzględną lub null
.
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
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object values, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object? values, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, values As Object, 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.
- endpointName
- String
Nazwa punktu końcowego. Służy do rozpoznawania punktów końcowych.
- values
- Object
Wartości trasy. Służy do rozwijania parametrów w szablonie trasy. Opcjonalny.
- 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 .
Zobacz sekcję uwagi, aby uzyskać szczegółowe informacje o implikacjach związanych z zabezpieczeniami elementu 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
Opcjonalny fragment identyfikatora URI. Dołączono do wynikowego identyfikatora URI.
- options
- LinkOptions
Opcjonalny LinkOptionselement . Ustawienia podanego obiektu zastępują ustawienia pasującymi nazwami z RouteOptions
.
Zwraca
Identyfikator URI ze ścieżką bezwzględną lub null
.
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.