LinkGenerator.GetUriByAddress Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions) |
Menghasilkan URI absolut berdasarkan nilai yang disediakan. |
GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions) |
Menghasilkan URI absolut berdasarkan nilai yang disediakan dan HttpContext. |
GetUriByAddress<TAddress>(TAddress, RouteValueDictionary, String, HostString, PathString, FragmentString, LinkOptions)
- Sumber:
- LinkGenerator.cs
Menghasilkan URI absolut berdasarkan nilai yang disediakan.
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 -> string
Public 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
Jenis parameter
- TAddress
Jenis alamat.
Parameter
- address
- TAddress
Nilai alamat. Digunakan untuk mengatasi titik akhir.
- values
- RouteValueDictionary
Nilai rute. Digunakan untuk memperluas parameter dalam templat rute.
- scheme
- String
Skema URI, diterapkan ke URI yang dihasilkan.
- host
- HostString
Host/otoritas URI, diterapkan ke URI yang dihasilkan.
Lihat bagian keterangan untuk detail tentang implikasi keamanan dari host
.
- pathBase
- PathString
Basis jalur URI opsional. Ditambahkan ke jalur dalam URI yang dihasilkan.
- fragment
- FragmentString
Fragmen URI opsional. Ditambahkan ke URI yang dihasilkan.
- options
- LinkOptions
LinkOptionsOpsional . Pengaturan pada objek yang disediakan mengambil alih pengaturan dengan nama yang cocok dari RouteOptions
.
Mengembalikan
URI absolut, atau null
.
Keterangan
Nilai host
harus menjadi nilai tepercaya. Mengandalkan nilai permintaan saat ini dapat memungkinkan input yang tidak tepercaya memengaruhi URI yang dihasilkan kecuali Host
header telah divalidasi. Lihat dokumentasi penyebaran untuk petunjuk tentang cara memvalidasi Host
header dengan benar di lingkungan penyebaran Anda.
Berlaku untuk
GetUriByAddress<TAddress>(HttpContext, TAddress, RouteValueDictionary, RouteValueDictionary, String, Nullable<HostString>, Nullable<PathString>, FragmentString, LinkOptions)
- Sumber:
- LinkGenerator.cs
Menghasilkan URI absolut berdasarkan nilai yang disediakan dan HttpContext.
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 -> string
Public 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
Jenis parameter
- TAddress
Jenis alamat.
Parameter
- httpContext
- HttpContext
Yang HttpContext terkait dengan permintaan saat ini.
- address
- TAddress
Nilai alamat. Digunakan untuk mengatasi titik akhir.
- values
- RouteValueDictionary
Nilai rute. Digunakan untuk memperluas parameter dalam templat rute.
- ambientValues
- RouteValueDictionary
Nilai yang terkait dengan permintaan saat ini. Pilihan.
- scheme
- String
Skema URI, diterapkan ke URI yang dihasilkan. Pilihan. Jika tidak disediakan, nilai Scheme akan digunakan.
- host
- Nullable<HostString>
Host/otoritas URI, diterapkan ke URI yang dihasilkan. Pilihan. Jika tidak disediakan, nilai Host akan digunakan.
Lihat bagian keterangan untuk detail tentang implikasi keamanan dari host
.
- pathBase
- Nullable<PathString>
Basis jalur URI opsional. Ditambahkan ke jalur dalam URI yang dihasilkan. Jika tidak disediakan, nilai PathBase akan digunakan.
- fragment
- FragmentString
Fragmen URI opsional. Ditambahkan ke URI yang dihasilkan.
- options
- LinkOptions
LinkOptionsOpsional . Pengaturan pada objek yang disediakan mengambil alih pengaturan dengan nama yang cocok dari RouteOptions
.
Mengembalikan
URI dengan jalur absolut, atau null
.
Keterangan
Nilai host
harus menjadi nilai tepercaya. Mengandalkan nilai permintaan saat ini dapat memungkinkan input yang tidak tepercaya memengaruhi URI yang dihasilkan kecuali Host
header telah divalidasi. Lihat dokumentasi penyebaran untuk petunjuk tentang cara memvalidasi Host
header dengan benar di lingkungan penyebaran Anda.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk