ControllerLinkGeneratorExtensions.GetUriByAction 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
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매개 변수
- generator
- LinkGenerator
- 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매개 변수
- generator
- LinkGenerator
- httpContext
- HttpContext
HttpContext 현재 요청과 연결된 입니다.
- action
- String
작업 이름입니다. 엔드포인트를 resolve 데 사용됩니다. 선택 사항입니다. 가 제공되면 null 현재 작업 경로 값이 사용됩니다.
- controller
- String
컨트롤러 이름입니다. 엔드포인트를 resolve 데 사용됩니다. 선택 사항입니다. 가 제공되면 null 현재 컨트롤러 경로 값이 사용됩니다.
- values
- Object
경로 값입니다. 선택 사항입니다. 엔드포인트를 resolve 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다.
- 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 배포 설명서를 참조하세요.