LinkGeneratorEndpointNameAddressExtensions.GetUriByName 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
제공된 값에 기반한 절대 URI를 생성합니다.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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);
static member GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName As String, 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
매개 변수
- generator
- LinkGenerator
- endpointName
- String
엔드포인트 이름입니다. 엔드포인트를 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
배포 설명서를 참조하세요.
적용 대상
GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
제공된 값에 기반한 절대 URI를 생성합니다.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string endpointName, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, endpointName 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
- endpointName
- String
엔드포인트 이름입니다. 엔드포인트를 resolve 데 사용됩니다.
- values
- Object
경로 값입니다. 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다. 선택 사항입니다.
- 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
배포 설명서를 참조하세요.
적용 대상
GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
제공된 값에 기반한 절대 URI를 생성합니다.
public static string? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, Microsoft.AspNetCore.Routing.RouteValueDictionary? 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * Microsoft.AspNetCore.Routing.RouteValueDictionary * string * Nullable<Microsoft.AspNetCore.Http.HostString> * Nullable<Microsoft.AspNetCore.Http.PathString> * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string
<Extension()>
Public Function GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, Optional values 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
매개 변수
- generator
- LinkGenerator
- httpContext
- HttpContext
HttpContext 현재 요청과 연결된 입니다.
- endpointName
- String
엔드포인트 이름입니다. 엔드포인트를 resolve 데 사용됩니다.
- values
- 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
배포 설명서를 참조하세요.
적용 대상
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
제공된 값에 기반한 절대 URI를 생성합니다.
public static string GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object values, 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? GetUriByName (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string endpointName, object? values, 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 GetUriByName : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * 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 GetUriByName (generator As LinkGenerator, httpContext As HttpContext, endpointName As String, values As Object, 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 현재 요청과 연결된 입니다.
- endpointName
- String
엔드포인트 이름입니다. 엔드포인트를 resolve 데 사용됩니다.
- values
- Object
경로 값입니다. 경로 템플릿에서 매개 변수를 확장하는 데 사용됩니다. 선택 사항입니다.
- 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
배포 설명서를 참조하세요.