LinkGenerator.GetUriByAddress 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
- Source:
- LinkGenerator.cs
제공된 값에 기반한 절대 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 -> stringPublic 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)
- Source:
- LinkGenerator.cs
제공된 값 및 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 -> stringPublic 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
현재 요청과 연결된 값입니다. 선택 사항입니다.
- 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 배포 설명서를 참조하세요.