ControllerLinkGeneratorExtensions.GetUriByAction 메서드

정의

오버로드

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

제공된 값에 기반한 절대 URI를 생성합니다.

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

제공된 값에 기반한 절대 URI를 생성합니다.

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

제공된 값에 기반한 절대 URI를 생성합니다.

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

매개 변수

action
String

작업 이름입니다. 엔드포인트를 resolve 데 사용됩니다.

controller
String

컨트롤러 이름입니다. 엔드포인트를 resolve 데 사용됩니다.

values
Object

경로 값입니다. null일 수 있습니다. 엔드포인트를 resolve 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다.

scheme
String

결과 URI에 적용된 URI 체계입니다.

host
HostString

결과 URI에 적용된 URI 호스트/기관입니다.

pathBase
PathString

선택적 URI 경로 기준입니다. 결과 URI의 경로 앞에 추가됩니다.

fragment
FragmentString

URI 조각입니다. 선택 사항입니다. 결과 URI에 추가됩니다.

options
LinkOptions

선택적 LinkOptions입니다. 제공된 개체의 설정은 의 RouteOptions이름과 일치하는 설정을 재정의합니다.

반환

절대 URI이거나 null URI를 만들 수 없는 경우 입니다.

설명

host 은 신뢰할 수 있는 값이어야 합니다. 헤더의 유효성을 검사하지 않는 한 현재 요청의 값을 사용하면 신뢰할 수 없는 입력이 결과 URI에 Host 영향을 줄 수 있습니다. 배포 환경에서 헤더의 유효성을 올바르게 검사하는 방법에 대한 지침은 Host 배포 설명서를 참조하세요.

적용 대상

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

제공된 값에 기반한 절대 URI를 생성합니다.

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

매개 변수

httpContext
HttpContext

HttpContext 현재 요청과 연결된 입니다.

action
String

작업 이름입니다. 엔드포인트를 resolve 데 사용됩니다. 선택 사항입니다. 가 제공되면 null 현재 작업 경로 값이 사용됩니다.

controller
String

컨트롤러 이름입니다. 엔드포인트를 resolve 데 사용됩니다. 선택 사항입니다. 가 제공되면 null 현재 컨트롤러 경로 값이 사용됩니다.

values
Object

경로 값입니다. 선택 사항입니다. 엔드포인트를 resolve 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다.

scheme
String

결과 URI에 적용된 URI 체계입니다. 선택 사항입니다. 제공되지 않으면 값 Scheme 이 사용됩니다.

host
Nullable<HostString>

결과 URI에 적용된 URI 호스트/기관입니다. 선택 사항입니다. 제공되지 않으면 값 Host 이 사용됩니다.

pathBase
Nullable<PathString>

선택적 URI 경로 기준입니다. 결과 URI의 경로 앞에 추가됩니다. 제공되지 않으면 값 PathBase 이 사용됩니다.

fragment
FragmentString

URI 조각입니다. 선택 사항입니다. 결과 URI에 추가됩니다.

options
LinkOptions

선택적 LinkOptions입니다. 제공된 개체의 설정은 의 RouteOptions이름과 일치하는 설정을 재정의합니다.

반환

절대 URI이거나 null URI를 만들 수 없는 경우 입니다.

설명

host 은 신뢰할 수 있는 값이어야 합니다. 헤더의 유효성을 검사하지 않는 한 현재 요청의 값을 사용하면 신뢰할 수 없는 입력이 결과 URI에 Host 영향을 줄 수 있습니다. 배포 환경에서 헤더의 유효성을 올바르게 검사하는 방법에 대한 지침은 Host 배포 설명서를 참조하세요.

적용 대상