LinkGenerator.GetUriByAddress Metoda

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Routing

Zestaw:

Microsoft.AspNetCore.Routing.Abstractions.dll

Pakiet:

Microsoft.AspNetCore.App.Ref v8.0.0

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)

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);

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 -> string

Public 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 String

Parametry 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

String

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.

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.

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 -> string

Public 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 String

Parametry 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

String

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.