UnauthorizedWebPart 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 UnauthorizedWebPart 控制項新執行個體的屬性資料。
多載
UnauthorizedWebPart(WebPart) |
當靜態 UnauthorizedWebPart 控制項 (或伺服器或使用者控制項) 授權失敗時呼叫,初始化 WebPart 控制項的新執行個體。 |
UnauthorizedWebPart(String, String, String, String) |
當動態 UnauthorizedWebPart 控制項 (或伺服器或使用者控制項) 授權失敗時呼叫,初始化 WebPart 控制項的新執行個體。 |
備註
建 UnauthorizedWebPart 構函式在其兩個多載中,都會呼叫 類別中的 ProxyWebPart 基底建構函式。 這些建構函式會每個初始化屬性資料,並建立 控制項的新實例 UnauthorizedWebPart 。
當 WebPartManager 控制項將控制項 WebPart 新增 (和其他伺服器或使用者控制項) 至控制項集合時,它會使用 IsAuthorized 方法檢查每個控制項。 如果控制項實例未獲得授權,控制項的某些屬性值 (例如其識別碼) 指派給新 UnauthorizedWebPart 控制項中的屬性,然後將 UnauthorizedWebPart 控制項新增至頁面的控制項樹狀結構,以取代授權失敗的控制項。
控制項 UnauthorizedWebPart 永遠不會在頁面中轉譯,而且使用者無法知道它存在。 不過, UnauthorizedWebPart 控制項也會做為預留位置、維護原始控制項在控制項樹狀結構中的位置,以及維護原始控制項的任何預先存在個人化資料。 如此一來,如果使用者先前將控制項個人化,就會因為某些原因而變成未經授權,稍後再授權一次,就可以還原使用者的個人化資料。
UnauthorizedWebPart(WebPart)
當靜態 UnauthorizedWebPart 控制項 (或伺服器或使用者控制項) 授權失敗時呼叫,初始化 WebPart 控制項的新執行個體。
public:
UnauthorizedWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);
public UnauthorizedWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);
new System.Web.UI.WebControls.WebParts.UnauthorizedWebPart : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.UnauthorizedWebPart
Public Sub New (webPart As WebPart)
參數
- webPart
- WebPart
由 WebPart 控制項授權失敗的 WebPartManager。
備註
建 UnauthorizedWebPart 構函式會採用靜態控制項 webPart
做為參數,其中 webPart
授權檢查失敗。 靜態控制項是在網頁的標記中宣告的控制項,而不是以程式設計方式新增。 建構函式會傳回 控制項的新實例,該實例 UnauthorizedWebPart 會新增至頁面的控制樹狀結構,以取代 webPart
。 如需詳細資訊,請參閱UnauthorizedWebPart。
另請參閱
適用於
UnauthorizedWebPart(String, String, String, String)
當動態 UnauthorizedWebPart 控制項 (或伺服器或使用者控制項) 授權失敗時呼叫,初始化 WebPart 控制項的新執行個體。
public:
UnauthorizedWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID);
public UnauthorizedWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID);
new System.Web.UI.WebControls.WebParts.UnauthorizedWebPart : string * string * string * string -> System.Web.UI.WebControls.WebParts.UnauthorizedWebPart
Public Sub New (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String)
參數
- originalID
- String
字串,包含已加入至 WebPartZoneBase 中,參與 Web 組件應用程式之原始伺服器或使用者控制項的 ID。
- originalTypeName
- String
字串,包含原始控制項的型別名稱。
- originalPath
- String
字串,包含使用者控制項的相對虛擬路徑,如果原始控制項是使用者控制項。
- genericWebPartID
- String
字串,包含用來包裝原始伺服器或使用者控制項之 GenericWebPart 控制項的 ID。
備註
當動態 WebPart 或其他伺服器控制項的授權檢查失敗時,就會呼叫建 UnauthorizedWebPart 構函式。 動態控制項是以程式設計方式新增至頁面的控制項,或是由來自網頁元件控制項目錄的使用者新增的控制項。 建 UnauthorizedWebPart 構函式會傳回 控制項的新實例 UnauthorizedWebPart ,以取代失敗授權的動態控制項。 如需詳細資訊,請參閱UnauthorizedWebPart。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應