NavigationManager 類別

定義

命名空間:

Microsoft.AspNetCore.Components

組件:

Microsoft.AspNetCore.Components.dll

套件:

Microsoft.AspNetCore.Components v10.0.0

來源:

NavigationManager.cs

提供查詢與管理 URI 導航的抽象。

public ref class NavigationManager abstract

public abstract class NavigationManager

type NavigationManager = class

Public MustInherit Class NavigationManager

繼承

Object

NavigationManager

建構函式

名稱	Description
NavigationManager()	提供查詢與管理 URI 導航的抽象。

屬性

名稱	Description
BaseUri	取得或設定目前的基礎 URI。 該 BaseUri 字母總是以絕對 URI 形式表示，並帶有尾斜線。 通常這對應於文件 <基底> 元素上的「href」屬性。
HistoryEntryState	取得或設定與當前導航相關的狀態。
Uri	取得或設定目前的 URI。 總是 Uri 以字串形式表示為絕對 URI。

方法

名稱	Description
EnsureInitialized()	允許衍生類別懶惰地自我初始化。 支援懶惰初始化的實作應覆寫此方法並呼叫 Initialize(String, String)。
HandleLocationChangingHandlerException(Exception, LocationChangingContext)	處理位置變更處理器拋出的例外。
Initialize(String, String)	在首次使用這些值之前，呼叫以初始化 BaseURI 及目前 URI。 覆寫 EnsureInitialized() 並呼叫此方法以動態計算這些數值。
NavigateTo(String, Boolean, Boolean)	導覽至指定的 URI。
NavigateTo(String, Boolean)	導覽至指定的 URI。
NavigateTo(String, NavigationOptions)	導覽至指定的 URI。
NavigateToCore(String, Boolean)	導覽至指定的 URI。
NavigateToCore(String, NavigationOptions)	導覽至指定的 URI。
NotFound()	處理設定 NotFound 狀態。
NotifyLocationChanged(Boolean)	觸發 LocationChanged 事件時會使用目前的 URI 值。
NotifyLocationChangingAsync(String, String, Boolean)	通知註冊的處理者目前位置變更。
Refresh(Boolean)	透過向伺服器的請求刷新當前頁面。
RegisterLocationChangingHandler(Func<LocationChangingContext,ValueTask>)	註冊一個事件處理器來處理進入的導覽事件。
SetNavigationLockState(Boolean)	設定導航是否目前鎖定。 如果是，那麼實作在先確認導覽NotifyLocationChangingAsync(String, String, Boolean)之前，不應更新Uri並呼叫NotifyLocationChanged(Boolean)。
ToAbsoluteUri(String)	將相對 URI 轉換成絕對 URI（相對於基礎 URI 解析）。
ToBaseRelativePath(String)	給定一個基礎 URI（例如先前由 BaseUri回傳的 URI），將絕對 URI 轉換為相對於基礎 URI 前綴的 URI。

事件

名稱	Description
LocationChanged	當導航位置發生變更時觸發的事件。
OnNotFound	當頁面未被找到時會觸發的事件。

擴充方法

名稱	Description
GetUriWithQueryParameter(NavigationManager, String, Boolean)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, DateOnly)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, DateTime)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Decimal)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Double)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Guid)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Int32)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Int64)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Boolean>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<DateOnly>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<DateTime>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Decimal>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Double>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Guid>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Int32>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Int64>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<Single>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Nullable<TimeOnly>)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, Single)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameter(NavigationManager, String, String)	回傳一個 URI，該 URI 是透過新增、更新或移除單一參數來建立 Uri 的。
GetUriWithQueryParameter(NavigationManager, String, TimeOnly)	回傳一個 URI，該 URI 是透過新增 Uri 或更新單一參數來建立的。
GetUriWithQueryParameters(NavigationManager, IReadOnlyDictionary<String,Object>)	回傳一個由多個參數加入、更新或移除的 URI Uri 。
GetUriWithQueryParameters(NavigationManager, String, IReadOnlyDictionary<String,Object>)	回傳一個由 uri 多個參數加入、更新或移除的 URI。
NavigateToLogin(NavigationManager, String, InteractiveRequestOptions)	透過導航至登入端點啟動登入操作。
NavigateToLogin(NavigationManager, String)	透過導航至登入端點啟動登入操作。
NavigateToLogout(NavigationManager, String, String)	透過導航到登出端點來啟動登出操作。
NavigateToLogout(NavigationManager, String)	透過導航到登出端點來啟動登出操作。