語言

UnauthorizedWebPart 建構函式

定義

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

初始化新的控制實例 UnauthorizedWebPart 的屬性資料。

多載

名稱 Description
UnauthorizedWebPart(WebPart)

初始化一個新的控制實例 UnauthorizedWebPart ，當靜態 WebPart 控制（或伺服器或使用者控制）授權失敗時呼叫。
UnauthorizedWebPart(String, String, String, String)

初始化一個新的控制實例 UnauthorizedWebPart ，當動態 WebPart 控制（或伺服器或使用者控制）授權失敗時被呼叫。

備註

UnauthorizedWebPart建構子在兩個過載中都會呼叫類別ProxyWebPart中的基底建構子。 這些建構子各自初始化屬性資料並建立新的控制項實例 UnauthorizedWebPart 。

當 WebPartManager 控制項將控制項（以及其他伺服器或使用者控制項）加入 WebPart 其控制項集合時，會使用該 IsAuthorized 方法檢查每個控制項。 若控制實例未被授權，控制項中的某些屬性值（如其 ID）會被指派到新 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

一個字串，包含原本伺服器或使用者控制項的 ID，該控制器被加入 WebPartZoneBase 以參與 Web Parts 應用程式。

originalTypeName
String

包含原始控制項類型名稱的字串。

originalPath
String

一個包含使用者控制項相對虛擬路徑的字串，若原始控制是使用者控制項。

genericWebPartID
String

包含包裹原始伺服器或使用者控制項的 ID GenericWebPart 的字串。

備註

當動態UnauthorizedWebPart或其他伺服器控制項在授權檢查中失敗時，會呼叫建WebPart構子。 動態控制項是指以程式化方式或由使用者從 Web Parts 控制項目錄中新增到頁面上的控制項。 建構子會 UnauthorizedWebPart 回傳一個新的控制實例 UnauthorizedWebPart ，以取代該授權失敗的動態控制。 如需詳細資訊，請參閱UnauthorizedWebPart。

另請參閱

適用於