LinkGenerator.GetUriByAddress 메서드

정의

오버로드

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

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

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

제공된 값 및 HttpContext를 기반으로 절대 URI를 생성합니다.

GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)

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

public abstract string GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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 abstract string? GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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 abstract string? GetUriByAddress<TAddress> (TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary 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);
abstract member GetUriByAddress : 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
Public MustOverride Function GetUriByAddress(Of TAddress) (address As TAddress, values As RouteValueDictionary, scheme As String, host As HostString, Optional pathBase As PathString = Nothing, Optional fragment As FragmentString = Nothing, Optional options As LinkOptions = Nothing) As String

형식 매개 변수

TAddress

주소 유형입니다.

매개 변수

address
TAddress

주소 값입니다. 엔드포인트를 resolve 데 사용됩니다.

values
RouteValueDictionary

경로 값입니다. 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다.

scheme
String

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

host
HostString

결과 URI에 적용된 URI 호스트/기관입니다. 의 보안 영향에 대한 자세한 내용은 설명 섹션을 host참조하세요.

pathBase
PathString

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

fragment
FragmentString

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

options
LinkOptions

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

반환

절대 URI 또는 null입니다.

설명

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

적용 대상

GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

제공된 값 및 HttpContext를 기반으로 절대 URI를 생성합니다.

public abstract string GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary ambientValues = 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 abstract string? GetUriByAddress<TAddress> (Microsoft.AspNetCore.Http.HttpContext httpContext, TAddress address, Microsoft.AspNetCore.Routing.RouteValueDictionary values, Microsoft.AspNetCore.Routing.RouteValueDictionary? ambientValues = 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);
abstract member GetUriByAddress : Microsoft.AspNetCore.Http.HttpContext * 'Address * Microsoft.AspNetCore.Routing.RouteValueDictionary * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
Public MustOverride Function GetUriByAddress(Of TAddress) (httpContext As HttpContext, address As TAddress, values As RouteValueDictionary, Optional ambientValues As RouteValueDictionary = 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

형식 매개 변수

TAddress

주소 유형입니다.

매개 변수

httpContext
HttpContext

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

address
TAddress

주소 값입니다. 엔드포인트를 resolve 데 사용됩니다.

values
RouteValueDictionary

경로 값입니다. 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다.

ambientValues
RouteValueDictionary

현재 요청과 연결된 값입니다. 선택 사항입니다.

scheme
String

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

host
Nullable<HostString>

결과 URI에 적용된 URI 호스트/기관입니다. 선택 사항입니다. 제공되지 않으면 값 Host 이 사용됩니다. 의 보안 영향에 대한 자세한 내용은 설명 섹션을 host참조하세요.

pathBase
Nullable<PathString>

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

fragment
FragmentString

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

options
LinkOptions

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

반환

절대 경로가 있는 URI 또는 null입니다.

설명

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

적용 대상