LinkGeneratorEndpointNameAddressExtensions.GetUriByName Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Generiert einen absoluten URI, der auf den angegebenen Werten basiert. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
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
Parameter
- generator
- LinkGenerator
Die LinkGenerator.
- endpointName
- String
Der Endpunktname. 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 host
Hinweisen.
- 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 RouteOptions
Kraft.
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:
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
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
Parameter
- generator
- LinkGenerator
Die LinkGenerator.
- endpointName
- String
Der Endpunktname. Wird verwendet, um Endpunkte aufzulösen.
- values
- Object
Die Routenwerte. Wird zum Erweitern von Parametern in der Routenvorlage verwendet. Optional.
- 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 host
Hinweisen.
- 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 RouteOptions
Kraft.
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:
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
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
Parameter
- generator
- LinkGenerator
Die LinkGenerator.
- httpContext
- HttpContext
Die HttpContext der aktuellen Anforderung zugeordnete.
- endpointName
- String
Der Endpunktname. Wird verwendet, um Endpunkte aufzulösen.
- values
- RouteValueDictionary
Die Routenwerte. Wird zum Erweitern von Parametern in der Routenvorlage verwendet. 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 host
Hinweisen.
- 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 RouteOptions
Kraft.
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:
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
Generiert einen absoluten URI, der auf den angegebenen Werten basiert.
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
Parameter
- generator
- LinkGenerator
Die LinkGenerator.
- httpContext
- HttpContext
Die HttpContext der aktuellen Anforderung zugeordnete.
- endpointName
- String
Der Endpunktname. Wird verwendet, um Endpunkte aufzulösen.
- values
- Object
Die Routenwerte. Wird zum Erweitern von Parametern in der Routenvorlage verwendet. 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 host
Hinweisen.
- 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 RouteOptions
Kraft.
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.