LinkGeneratorEndpointNameAddressExtensions.GetUriByName Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
| GetUriByName(LinkGenerator, String, Object, String, HostString, PathString, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
| GetUriByName(LinkGenerator, HttpContext, String, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
| GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Создает абсолютный URI на основе предоставленных значений. |
GetUriByName(LinkGenerator, String, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
Создает абсолютный 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
Имя конечной точки. Используется для разрешения конечных точек.
- 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)
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
Создает абсолютный 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
Имя конечной точки. Используется для разрешения конечных точек.
- 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)
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
Создает абсолютный 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
Имя конечной точки. Используется для разрешения конечных точек.
- 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 в среде развертывания см. в документации по развертыванию.
Применяется к
GetUriByName(LinkGenerator, HttpContext, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
- Исходный код:
- LinkGeneratorEndpointNameAddressExtensions.cs
Создает абсолютный 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
Имя конечной точки. Используется для разрешения конечных точек.
- 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 должно быть доверенным значением. Использование значения текущего запроса может позволить ненадежным входным данным влиять на результирующий URI, если Host заголовок не был проверен. Инструкции по правильной проверке заголовка Host в среде развертывания см. в документации по развертыванию.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по