LinkGenerator.GetUriByAddress 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
| GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości. |
| GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generuje bezwzględny identyfikator URI na podstawie podanych wartości i HttpContext. |
GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
- Źródło:
- LinkGenerator.cs
Generuje bezwzględny identyfikator URI na podstawie podanych wartości.
public abstract string GetUriByAddress<TAddress> (TAddress address, 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);public abstract string? GetUriByAddress<TAddress> (TAddress address, 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);public abstract string? GetUriByAddress<TAddress> (TAddress address, 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);abstract member GetUriByAddress : 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> stringPublic MustOverride Function GetUriByAddress(Of TAddress) (address As TAddress, 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 StringParametry typu
- TAddress
Typ adresu.
Parametry
- address
- TAddress
Wartość adresu. 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
Identyfikator URI host/urząd zastosowany do wynikowego identyfikatora URI.
Zobacz sekcję uwagi, aby uzyskać szczegółowe informacje o implikacjach dotyczących zabezpieczeń 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 element LinkOptions. Ustawienia w podanym obiekcie zastępują ustawienia pasującymi nazwami z elementu 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 umożliwić niezaufanym wejściom 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
GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Źródło:
- LinkGenerator.cs
Generuje bezwzględny identyfikator URI na podstawie podanych wartości i HttpContext.
public abstract string GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary ambientValues = 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 abstract string? GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary? ambientValues = 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);abstract member GetUriByAddress : Microsoft.AspNetCore.Http.HttpContext * 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> stringPublic MustOverride Function GetUriByAddress(Of TAddress) (httpContext As HttpContext, address As TAddress, values As RouteValueDictionary, Optional ambientValues 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 StringParametry typu
- TAddress
Typ adresu.
Parametry
- httpContext
- HttpContext
Element HttpContext skojarzony z bieżącym żądaniem.
- address
- TAddress
Wartość adresu. Służy do rozpoznawania punktów końcowych.
- values
- RouteValueDictionary
Wartości trasy. Służy do rozwijania parametrów w szablonie trasy.
- ambientValues
- RouteValueDictionary
Wartości skojarzone z bieżącym żądaniem. 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>
Identyfikator URI host/urząd 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 dotyczących zabezpieczeń 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 element LinkOptions. Ustawienia w podanym obiekcie zastępują ustawienia pasującymi nazwami z elementu 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 umożliwić niezaufanym wejściom 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.