LinkGeneratorRouteValuesAddressExtensions.GetUriByRouteValues Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
GetUriByRouteValues(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
GetUriByRouteValues(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
GetUriByRouteValues(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
GetUriByRouteValues(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
GetUriByRouteValues(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
Создает абсолютный URI на основе предоставленных значений.
public static string? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string? routeName, 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 GetUriByRouteValues : 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 GetUriByRouteValues (generator As LinkGenerator, routeName 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
- routeName
- String
Имя маршрута. Используется для разрешения конечных точек. Необязательный элемент.
- 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
в среде развертывания см. в документации по развертыванию.
Применяется к
GetUriByRouteValues(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
Создает абсолютный URI на основе предоставленных значений.
public static string GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string routeName, 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? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string? routeName, 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 GetUriByRouteValues : 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 GetUriByRouteValues (generator As LinkGenerator, routeName 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
- routeName
- String
Имя маршрута. Используется для разрешения конечных точек. Необязательный элемент.
- 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
в среде развертывания см. в документации по развертыванию.
Применяется к
GetUriByRouteValues(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
Создает абсолютный URI на основе предоставленных значений.
public static string? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? routeName, 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 GetUriByRouteValues : 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 GetUriByRouteValues (generator As LinkGenerator, httpContext As HttpContext, routeName 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 связанный с текущим запросом.
- routeName
- String
Имя маршрута. Используется для разрешения конечных точек. Необязательный элемент.
- values
- 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
в среде развертывания см. в документации по развертыванию.
Применяется к
GetUriByRouteValues(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
- Исходный код:
- LinkGeneratorRouteValuesAddressExtensions.cs
Создает абсолютный URI на основе предоставленных значений.
public static string GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string routeName, 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? GetUriByRouteValues (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? routeName, 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 GetUriByRouteValues : 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 GetUriByRouteValues (generator As LinkGenerator, httpContext As HttpContext, routeName 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 связанный с текущим запросом.
- routeName
- String
Имя маршрута. Используется для разрешения конечных точек. Необязательный элемент.
- values
- Object
Значения маршрута. Используется для разрешения конечных точек и развертывания параметров в шаблоне маршрута. Необязательный элемент.
- 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
должно быть доверенным значением. Использование значения текущего запроса может позволить ненадежным входным данным влиять на результирующий универсальный Host
код ресурса (URI), если только заголовок не был проверен. Инструкции по правильной проверке заголовка Host
в среде развертывания см. в документации по развертыванию.