PageLinkGeneratorExtensions.GetUriByPage Methode

Definition

Überlädt

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

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

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

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

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

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

public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string handler, 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? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * string * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByPage (generator As LinkGenerator, page As String, handler 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.

page
String

Der Name der Seite. Wird verwendet, um Endpunkte aufzulösen.

handler
String

Der Name des Seitenhandlers. Ist möglicherweise NULL.

values
Object

Die Routenwerte. Ist möglicherweise NULL. Wird verwendet, um Endpunkte aufzulösen und Parameter in der Routenvorlage zu erweitern.

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.

pathBase
PathString

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

fragment
FragmentString

Ein URI-Fragment. Optional. 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 , wenn kein URI erstellt werden kann.

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:

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

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

public static string GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string page = default, string handler = default, object 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);
public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = default, object? 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler As String = Nothing, Optional values As Object = 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.

page
String

Der Name der Seite. Wird verwendet, um Endpunkte aufzulösen. Optional. Wenn null angegeben wird, wird der aktuelle Seitenroutenwert verwendet.

handler
String

Der Name des Seitenhandlers. Wird verwendet, um Endpunkte aufzulösen. Optional.

values
Object

Die Routenwerte. Optional. Wird verwendet, um Endpunkte aufzulösen und Parameter in der Routenvorlage zu erweitern.

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.

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 URI-Fragment. Optional. 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 , wenn kein URI erstellt werden kann.

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: