PageLinkGeneratorExtensions.GetUriByPage Метод

Определение

Пространство имен:

Microsoft.AspNetCore.Routing

Сборка:

Microsoft.AspNetCore.Mvc.Core.dll

Пакет:

Microsoft.AspNetCore.App.Ref v9.0.0

Перегрузки

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)	Создает абсолютный URI на основе предоставленных значений.
GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)	Создает абсолютный URI на основе предоставленных значений.

GetUriByPage(LinkGenerator, String, String, Object, String, HostString, PathString, FragmentString, LinkOptions)

Создает абсолютный URI на основе предоставленных значений.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, string page, string? handler, 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * string * string * obj * string * Microsoft.AspNetCore.Http.HostString * Microsoft.AspNetCore.Http.PathString * Microsoft.AspNetCore.Http.FragmentString * Microsoft.AspNetCore.Routing.LinkOptions -> string

<Extension()>
Public Function GetUriByPage (generator As LinkGenerator, page As String, handler 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

LinkGenerator.

page

String

Имя страницы. Используется для разрешения конечных точек.

handler

String

Имя обработчика страницы. Может принимать значение NULL.

values

Object

Значения маршрута. Может принимать значение NULL. Используется для разрешения конечных точек и развертывания параметров в шаблоне маршрута.

scheme

String

Схема URI, примененная к результирующему URI.

host

HostString

Узел или центр URI, примененный к результирующему URI.

pathBase

PathString

Необязательный путь URI. Добавляется к пути в результирующем универсальном коде ресурса (URI).

fragment

FragmentString

Фрагмент URI. Необязательный элемент. Добавляется к результирующему URI.

options

LinkOptions

Необязательный класс LinkOptions. Параметры предоставленного объекта переопределяют параметры с соответствующими именами из RouteOptions.

Возвращаемое значение

String

Абсолютный URI или null значение , если не удается создать URI.

Комментарии

Значение host должно быть доверенным значением. Использование значения текущего запроса может позволить ненадежным входным данным влиять на результирующий URI, если Host заголовок не был проверен. Инструкции по правильной проверке заголовка Host в среде развертывания см. в документации по развертыванию.

GetUriByPage(LinkGenerator, HttpContext, String, String, Object, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)

Создает абсолютный URI на основе предоставленных значений.

public static string? GetUriByPage (this Microsoft.AspNetCore.Routing.LinkGenerator generator, Microsoft.AspNetCore.Http.HttpContext httpContext, string? page = default, string? handler = default, object? 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 GetUriByPage : Microsoft.AspNetCore.Routing.LinkGenerator * Microsoft.AspNetCore.Http.HttpContext * string * 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 GetUriByPage (generator As LinkGenerator, httpContext As HttpContext, Optional page As String = Nothing, Optional handler As String = Nothing, Optional values As Object = 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

LinkGenerator.

httpContext

HttpContext

Объект , HttpContext связанный с текущим запросом.

page

String

Имя страницы. Используется для разрешения конечных точек. Необязательный элемент. Если null указан параметр , будет использоваться текущее значение маршрута страницы.

handler

String

Имя обработчика страницы. Используется для разрешения конечных точек. Необязательный элемент.

values

Object

Значения маршрута. Необязательный элемент. Используется для разрешения конечных точек и развертывания параметров в шаблоне маршрута.

scheme

String

Схема URI, примененная к результирующему URI. Необязательный элемент. Если этот параметр не указан, будет использоваться значение Scheme .

host

Nullable<HostString>

Узел или центр URI, примененный к результирующему URI. Необязательный элемент. Если значение не указано, будет использоваться значение Host .

pathBase

Nullable<PathString>

Необязательный путь URI. Добавляется к пути в результирующем универсальном коде ресурса (URI). Если этот параметр не указан, будет использоваться значение PathBase .

fragment

FragmentString

Фрагмент URI. Необязательный элемент. Добавляется к результирующему URI.

options

LinkOptions

Необязательный класс LinkOptions. Параметры предоставленного объекта переопределяют параметры с соответствующими именами из RouteOptions.

Возвращаемое значение

String

Абсолютный URI или null значение , если не удается создать URI.

Комментарии

Значение host должно быть доверенным значением. Использование значения текущего запроса может позволить ненадежным входным данным влиять на результирующий URI, если Host заголовок не был проверен. Инструкции по правильной проверке заголовка Host в среде развертывания см. в документации по развертыванию.