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
• IsAuthorized
• ASP.NET 網頁元件控制項

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。

另請參閱

• UnauthorizedWebPart
• IsAuthorized
• ASP.NET 網頁元件控制項