ControllerLinkGeneratorExtensions.GetUriByAction Metoda

Definicja

Przeciążenia

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

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

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

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

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

Źródło:
ControllerLinkGeneratorExtensions.cs

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

public static string GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string action, string controller, 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, action As String, controller 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

Parametry

generator
LinkGenerator

Element LinkGenerator.

action
String

Nazwa akcji. Służy do rozpoznawania punktów końcowych.

controller
String

Nazwa kontrolera. Służy do rozpoznawania punktów końcowych.

values
Object

Wartości trasy. Może mieć wartość null. Służy do rozpoznawania punktów końcowych i 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.

pathBase
PathString

Opcjonalna baza ścieżki identyfikatora URI. Prepended do ścieżki w wynikowym identyfikatorze URI.

fragment
FragmentString

Fragment identyfikatora URI. Opcjonalny. 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 jeśli nie można utworzyć identyfikatora URI.

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

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

Źródło:
ControllerLinkGeneratorExtensions.cs

Generuje bezwzględny identyfikator URI na podstawie podanych wartości.

public static string GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string action = default, string controller = 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? GetUriByAction (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? action = default, string? controller = 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 GetUriByAction : 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 GetUriByAction (generator As LinkGenerator, httpContext As HttpContext, Optional action As String = Nothing, Optional controller 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

Parametry

generator
LinkGenerator

Element LinkGenerator.

httpContext
HttpContext

Element HttpContext skojarzony z bieżącym żądaniem.

action
String

Nazwa akcji. Służy do rozpoznawania punktów końcowych. Opcjonalny. Jeśli null zostanie podana wartość trasy bieżącej akcji, zostanie użyta.

controller
String

Nazwa kontrolera. Służy do rozpoznawania punktów końcowych. Opcjonalny. Jeśli null zostanie podana wartość trasy bieżącego kontrolera, zostanie użyta.

values
Object

Wartości trasy. Opcjonalny. Służy do rozpoznawania punktów końcowych i rozwijania parametrów w szablonie trasy.

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 .

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

Fragment identyfikatora URI. Opcjonalny. 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 jeśli nie można utworzyć identyfikatora URI.

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