WebPartManagerInternals 类

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

分离到由 WebPartManager 控件使用并且可由扩展该控件的网页开发人员重写的单独的类方法中，但是网页开发人员很少需要使用这些方法。

public ref class WebPartManagerInternals sealed

public sealed class WebPartManagerInternals

type WebPartManagerInternals = class

Public NotInheritable Class WebPartManagerInternals

继承

Object

WebPartManagerInternals

注解

类 WebPartManager 是 Web 部件控件集中最大的类。 它也是最重要的 Web 部件类之一，因为它用于包含 Web 部件控件的每个网页上，并协调和管理页面上的所有 Web 部件控件。

WebPartManager由于 类的使用非常频繁，并且它包含大量公开的方法，因此扩展控件的控件开发人员WebPartManager所需的一些方法包含在 类中WebPartManagerInternals。 将不太使用的方法隔离到 WebPartManagerInternals 类中可以简化 类的 WebPartManager API，并且独立方法不会显示在 IntelliSense 中的 对象上 WebPartManager 。

使用 类的 WebPartManagerInternals 开发人员可能会有需要从 WebPartManager 控件继承并广泛自定义的场景。 例如，如果要使用自定义显示模式、自定义区域、自定义谓词、自定义 WebPart 控件以及基本 Web 部件用户界面 (UI) 的其他扩展生成 Web 门户应用程序或一组打包的 Web 部件控件，则在许多情况下 (并非所有) 都需要重写和扩展某些 WebPartManager 成员。 尽管类是密封的 WebPartManagerInternals ，因此您无法从它继承，但您的自定义 WebPartManager 类可能需要调用多个 WebPartManagerInternals 方法才能管理页面上的 Web 部件控件。

注意

WebPartManager与 类一样， WebPartManagerInternals 类提供没有 UI 且永远不会在页面上可见的服务器控件。 与 不同 WebPartManager， WebPartManagerInternals 类永远不会在页面的标记中声明;它严格来说就是执行后台任务的工作器对象。 类演示 WebPartManager 了使用它的典型方式，类通过受保护的 Internals 属性引用它，并使用引用的对象调用 WebPartManagerInternals 方法。

类 WebPartManagerInternals 仅包含方法;没有属性或事件。 类中的所有方法都涉及管理 WebPart 控件或控件之间的连接。

若要处理 WebPart 控件， WebPartManagerInternals 包括用于 (AddWebPart) 添加控件、) 删除它们 RemoveWebPart 、处理事件 CallOnDeleting) 、获取或设置它们与其区域关系的详细信息 (（例如 GetZoneID ）和 SetZoneIndex) 的方法，或设置基本 WebPart 控件属性 (（例如） SetIsClosed 和 SetHasSharedData) 。

若要处理连接， WebPartManagerInternals 包括 (DeleteConnection) 删除连接的方法、设置要使用的转换器对象 (SetTransformer) 、设置连接是否共享以及连接是否为静态 (SetIsShared(WebPartConnection, Boolean) 和 SetIsStatic(WebPartConnection, Boolean)) ，以及将连接错误消息设置为使用 (SetConnectErrorMessage) 。

方法

AddWebPart(WebPart)	将一个 WebPart 或服务器控件添加到网页上的 WebPartManager 控件的 WebPart 控件集合中。
CallOnClosing(WebPart)	调用指定控件的 OnClosing(EventArgs) 方法。
CallOnConnectModeChanged(WebPart)	调用指定控件的 OnConnectModeChanged(EventArgs) 方法。
CallOnDeleting(WebPart)	调用指定控件的 OnDeleting(EventArgs) 方法。
CallOnEditModeChanged(WebPart)	调用指定控件的 OnEditModeChanged(EventArgs) 方法。
ConnectionDeleted(WebPartConnection)	指示指定的 WebPartConnection 对象是否已删除。
CreateObjectFromType(Type)	根据传递给该方法的参数创建一个对象。
DeleteConnection(WebPartConnection)	设置一个属性以指示指定的连接对象是否已删除。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetZoneID(WebPart)	获取包含指定 WebPart 或服务器控件的区域的 ID。
LoadConfigurationState(WebPartTransformer, Object)	加载参与两个控件之间的连接的 WebPartTransformer 对象的以前保存的状态数据。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RemoveWebPart(WebPart)	从 WebPart 控件的控件集合中移除 WebPartManager 或其他服务器控件。
SaveConfigurationState(WebPartTransformer)	保存参与两个控件之间的连接的 WebPartTransformer 对象的状态数据。
SetConnectErrorMessage(WebPart, String)	建立错误信息，并且使得负责呈现 WebPartChrome 控件的 WebPart 对象呈现该消息而不是呈现控件的内容。
SetHasSharedData(WebPart, Boolean)	设置 WebPart 或其他服务器控件上的一个指示该控件是否具有共享个性化数据的属性。
SetHasUserData(WebPart, Boolean)	设置 WebPart 或其他服务器控件上的一个指示该控件是否具有用户个性化数据的属性。
SetIsClosed(WebPart, Boolean)	设置 IsClosed 控件的 WebPart 属性。
SetIsShared(WebPart, Boolean)	设置 IsShared 控件的 WebPart 属性。
SetIsShared(WebPartConnection, Boolean)	设置 IsShared 对象的 WebPartConnection 属性。
SetIsStandalone(WebPart, Boolean)	设置 IsStandalone 控件的 WebPart 属性。
SetIsStatic(WebPart, Boolean)	设置 IsStatic 控件的 WebPart 属性。
SetIsStatic(WebPartConnection, Boolean)	设置 IsStatic 对象的 WebPartConnection 属性。
SetTransformer(WebPartConnection, WebPartTransformer)	分配一个将在两个服务器控件之间的连接中使用的 WebPartTransformer 对象。
SetZoneID(WebPart, String)	设置一个允许 WebPart 或服务器控件保留包含区域的 ID 的属性。
SetZoneIndex(WebPart, Int32)	在特定控件所在区域中设置相对于该区域中其他 WebPart 控件的该特定控件的索引。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• WebPartManager
• ASP.NET Web 部件控件