Freigeben über


LinkGenerator.GetUriByAddress Methode

Definition

Überlädt

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

Generiert einen absoluten URI, der auf den angegebenen Werten basiert.

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Generiert einen absoluten URI basierend auf den angegebenen Werten und HttpContext.

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

Quelle:
LinkGenerator.cs

Generiert einen absoluten URI, der auf den angegebenen Werten basiert.

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

Typparameter

TAddress

Der Adresstyp.

Parameter

address
TAddress

Der Adresswert. Wird verwendet, um Endpunkte aufzulösen.

values
RouteValueDictionary

Die Routenwerte. Wird zum Erweitern von Parametern in der Routenvorlage verwendet.

scheme
String

Das URI-Schema, das auf den resultierenden URI angewendet wird.

host
HostString

Der URI-Host/die -Autorität, die auf den resultierenden URI angewendet wird. Ausführliche Informationen zu den Sicherheitsauswirkungen von finden Sie im Abschnitt mit den hostHinweisen.

pathBase
PathString

Eine optionale URI-Pfadbasis. Wird dem Pfad im resultierenden URI vorangestellt.

fragment
FragmentString

Ein optionales URI-Fragment. Wird an den resultierenden URI angefügt.

options
LinkOptions

Eine optionale LinkOptions-Klasse. Einstellungen für das bereitgestellte Objekt setzen die Einstellungen mit übereinstimmenden Namen aus außer RouteOptionsKraft.

Gibt zurück

Ein absoluter URI oder null.

Hinweise

Der Wert von host sollte ein vertrauenswürdiger Wert sein. Wenn Sie sich auf den Wert der aktuellen Anforderung verlassen, kann es nicht vertrauenswürdigen Eingaben ermöglichen, den resultierenden URI zu beeinflussen, es sei denn, der Host Header wurde überprüft. Anweisungen zum ordnungsgemäßen Überprüfen des Headers in Ihrer Bereitstellungsumgebung finden Sie in der Host Bereitstellungsdokumentation.

Gilt für:

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Quelle:
LinkGenerator.cs

Generiert einen absoluten URI basierend auf den angegebenen Werten und 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 -> 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

Typparameter

TAddress

Der Adresstyp.

Parameter

httpContext
HttpContext

Die HttpContext der aktuellen Anforderung zugeordnete.

address
TAddress

Der Adresswert. Wird verwendet, um Endpunkte aufzulösen.

values
RouteValueDictionary

Die Routenwerte. Wird zum Erweitern von Parametern in der Routenvorlage verwendet.

ambientValues
RouteValueDictionary

Die Werte, die der aktuellen Anforderung zugeordnet sind. Optional.

scheme
String

Das URI-Schema, das auf den resultierenden URI angewendet wird. Optional. Wenn nicht angegeben, wird der Wert von Scheme verwendet.

host
Nullable<HostString>

Der URI-Host/die -Autorität, die auf den resultierenden URI angewendet wird. Optional. Wenn nicht angegeben, wird der Wert Host verwendet. Ausführliche Informationen zu den Sicherheitsauswirkungen von finden Sie im Abschnitt mit den hostHinweisen.

pathBase
Nullable<PathString>

Eine optionale URI-Pfadbasis. Wird dem Pfad im resultierenden URI vorangestellt. Wenn nicht angegeben, wird der Wert von PathBase verwendet.

fragment
FragmentString

Ein optionales URI-Fragment. Wird an den resultierenden URI angefügt.

options
LinkOptions

Eine optionale LinkOptions-Klasse. Einstellungen für das bereitgestellte Objekt setzen die Einstellungen mit übereinstimmenden Namen aus außer RouteOptionsKraft.

Gibt zurück

Ein URI mit einem absoluten Pfad oder null.

Hinweise

Der Wert von host sollte ein vertrauenswürdiger Wert sein. Wenn Sie sich auf den Wert der aktuellen Anforderung verlassen, kann es nicht vertrauenswürdigen Eingaben ermöglichen, den resultierenden URI zu beeinflussen, es sei denn, der Host Header wurde überprüft. Anweisungen zum ordnungsgemäßen Überprüfen des Headers in Ihrer Bereitstellungsumgebung finden Sie in der Host Bereitstellungsdokumentation.

Gilt für: