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 方法检查每个控件。 如果控件实例未经授权，则将控件 (中的某些属性值（例如其 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
• IsAuthorized
• ASP.NET Web 部件控件

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 部件应用程序的一部分。

originalTypeName

String

一个字符串，包含原始控件的类型的名称。

originalPath

String

一个字符串，包含用户控件（如果原始控件是用户控件）的相对虚拟路径。

genericWebPartID

String

包含 GenericWebPart 控件的 ID 的字符串，该控件包装原始服务器控件或原始用户控件。

注解

当 UnauthorizedWebPart 动态 WebPart 或其他服务器控件的授权检查失败时，将调用构造函数。 动态控件是以编程方式添加到页面的控件，或由 Web 部件控件目录中的用户添加的控件。 构造 UnauthorizedWebPart 函数返回控件的新实例 UnauthorizedWebPart ，以替换授权失败的动态控件。 有关详细信息，请参阅 UnauthorizedWebPart。

另请参阅

• UnauthorizedWebPart
• IsAuthorized
• ASP.NET Web 部件控件