ControllerLinkGeneratorExtensions.GetUriByAction Metoda

Definicja

Przestrzeń nazw:

Microsoft.AspNetCore.Routing

Zestaw:

Microsoft.AspNetCore.Mvc.Core.dll

Pakiet:

Microsoft.AspNetCore.App.Ref v9.0.0

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)

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

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

String

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.

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

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

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

String

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.