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.UnauthorizedWebPartPublic 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.UnauthorizedWebPartPublic 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。
備註
UnauthorizedWebPart當動態WebPart或其他伺服器控制項失敗其授權檢查時，會呼叫建構函式。 動態控制項是透過程式設計方式新增至頁面的控制項，或是由使用者從網頁元件目錄新增的控制件。 建 UnauthorizedWebPart 構函式會傳回控件的新實例 UnauthorizedWebPart ，以取代失敗授權的動態控件。 如需詳細資訊，請參閱UnauthorizedWebPart。
