共用方式為

UnauthorizedWebPart 建構函式

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

初始化 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。

備註

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

另請參閱

適用於