GenericWebPart 类

定义

对不是 WebPart 控件的服务器控件进行包装,使其在运行时与真正的 WebPart 控件具有相同的外观和行为。Wraps server controls that are not WebPart controls so that they can appear and behave as true WebPart controls at run time.

public ref class GenericWebPart : System::Web::UI::WebControls::WebParts::WebPart
public class GenericWebPart : System.Web.UI.WebControls.WebParts.WebPart
type GenericWebPart = class
    inherit WebPart
Public Class GenericWebPart
Inherits WebPart
继承

示例

下面的代码示例演示GenericWebPart控件如何在运行时自动包装WebPart不是控件的服务器控件。The following code example demonstrates how the GenericWebPart control automatically wraps a server control that is not a WebPart control at run time.

此代码示例的第一部分包含一个 Web 部件页面, 其中包含WebPartZone两个控件。The first part of the code example contains a Web Parts page with two WebPartZone controls. 每个区域中都是标准的 ASP.NET 服务器控件。Within each zone is a standard ASP.NET server control. 由于控件在WebPartZone区域中, 因此在编译页面时, 这些控件将GenericWebPart自动与控件一起包装。Because the controls are in a WebPartZone zone, they will be automatically wrapped with a GenericWebPart control when the page is compiled. 因此, 可以在这些WebPart控件上声明类属性。So, you can declare WebPart class properties on these controls. 在浏览器中加载页面后, 如果单击 "显示所有属性值" 按钮, 则每个控件的详细信息将显示在标签中。After you load the page in a browser, if you click the Display All Property Values button, the details for each control are displayed in a label. 若要显示控件GenericWebPart的工作方式, Calendar第一个GenericWebPart区域中的控件在 .aspx 页的声明性标记中设置了某些属性, 而该BulletedList控件没有。To show how the GenericWebPart control works, the Calendar control in the first zone has some of the GenericWebPart properties set in the declarative markup of the .aspx page, whereas the BulletedList control does not. 加载页面后, 请注意两个控件的属性值之间的差异, 并且两者都具有父GenericWebPart控件。After you load the page, note the differences in the property values for the two controls, and that both have a parent GenericWebPart control.

<%@ Page Language="C#" 
  Codefile="genericwebpart.cs" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>
<%@ Page Language="vb" 
  Codefile="genericwebpart.vb" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>

此代码示例的第二部分演示以编程方式访问GenericWebPart控件的某些属性的分部类。The second part of the code example shows a partial class that accesses some properties of the GenericWebPart control programmatically. 请注意, 在Page_Load方法中GetGenericWebPart , 方法用于检索包装服务器控件的GenericWebPart控件的运行时实例。Notice that in the Page_Load method, the GetGenericWebPart method is used to retrieve the run-time instance of the GenericWebPart control that wraps a server control. 这种获取对父GenericWebPart控件的引用的方法使你能够以编程方式使用普通服务器或用户控件, 就像它在运行时是WebPart控件。This approach of getting a reference to the parent GenericWebPart control enables you to work programmatically with an ordinary server or user control as if it were a WebPart control at run time.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class genericwebpart_sample : System.Web.UI.Page
{
  GenericWebPart calendarPart;
  GenericWebPart listPart;

  protected void Page_Load(Object sender, EventArgs e)
  {
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1);
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1);

    if (!IsPostBack)
    {
      Label2.Text = String.Empty;
      Label3.Text = String.Empty;
    }
  }

  protected void Button1_Click(object sender, EventArgs e)
  {

    Label2.Text =
      @"<h3>Calendar GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + calendarPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + calendarPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + calendarPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

    Label3.Text =
      @"<h3>BulletedList GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + listPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + listPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + listPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + listPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
  }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Partial Public Class genericwebpart_sample

  Inherits System.Web.UI.Page

  Private calendarPart As GenericWebPart
  Private listPart As GenericWebPart

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1)
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1)

    If Not IsPostBack Then
      Label2.Text = String.Empty
      Label3.Text = String.Empty
    End If

  End Sub


  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

注解

控件存在, 以提供不WebPart是控件的服务器控件的运行时包装程序, 以便可以在 Web 部件页面和应用程序中使用此类控件。 GenericWebPartThe GenericWebPart control exists to provide a run-time wrapper for server controls that are not WebPart controls, so that such controls can be used in Web Parts pages and applications. 当开发人员将服务器控件 (例如用户控件、ASP.NET 服务器控件或现有的自定义控件) 添加到WebPartZoneBase控件时GenericWebPart , 控件将在运行时自动包装服务器控件, 以便它们可以表现出相同的作为真实WebPart控件的功能。When developers add server controls--such as user controls, ASP.NET server controls, or existing custom controls--to a WebPartZoneBase control, the GenericWebPart control automatically wraps the server controls at run time so they can exhibit the same functionality as true WebPart controls.

下表比较了控件和GenericWebPart WebPart控件并对其进行了对比。The following table compares and contrasts GenericWebPart controls and WebPart controls.

GenericWebPart 控件GenericWebPart control WebPart 控件WebPart control
存在用于对不WebPart是控件的服务器控件进行 Web 部件功能, 使任何 ASP.NET、自定义控件或用户控件都可以参与 Web 部件应用程序。Exists to equip server controls that are not WebPart controls with Web Parts functionality, so that any ASP.NET, custom, or user control can participate in Web Parts applications. 存在, 用于创建在中内置了本机 Web 部件功能的自定义 ASP.NET 控件。Exists to create custom ASP.NET controls that have native Web Parts functionality built in. 这包括个性化设置、连接、导入和导出以及拖放功能。This includes personalization, connections, import and export, and drag-and-drop capabilities.
永远不会在页的标记中声明。Is never declared in the markup of a page. 它仅用于在运行时包装服务器控件, 并为包装的控件 (或子控件) 授予WebPart控件的全部功能。It exists only to wrap server controls at run time, and to give the wrapped control (or child control) the full functionality of a WebPart control. 可在设计时在页面的标记中声明, 类似于 ASP.NET 服务器控件, 只不过它是在WebPartZoneBase区域中声明的。Can be declared in the markup of a page at design time, like an ASP.NET server control, except that it is declared in a WebPartZoneBase zone.
包含其子控件并将其集成到 Web 部件个性化设置过程中, 以便它可用作WebPart真正的控件。Includes and integrates its child control into the Web Parts personalization process so that it can act as a true WebPart control. 这会自动发生, 使开发人员可以轻松地在 Web 部件的应用程序中使用服务器控件和用户控件。This occurs automatically, which makes it simple for developers to use server controls and user controls in Web Parts applications. 将自动包含在 Web 部件的个性化设置过程中。Is automatically included in the Web Parts personalization process.
可以在运行时以编程方式访问 (通过使用GetGenericWebPart方法并向其传递子服务器控件), 例如 true WebPart控件或标准 ASP.NET 控件。Can be accessed programmatically at run time (by using the GetGenericWebPart method and passing to it the child server control), like a true WebPart control or a standard ASP.NET control. 可以在运行时以编程方式访问, 如标准 ASP.NET 控件。Can be accessed programmatically at run time, like a standard ASP.NET control.

用户受益于GenericWebPart控制, 因为它提供一致的用户体验。Users benefit from the GenericWebPart control because it provides a consistent user experience. 任何服务器控件都可以像WebPart控件一样运行, 并且具有相同的一致用户界面 (UI) 元素, 如谓词、图标、标题和标头。Any server control can be made to function like a WebPart control, and will have the same consistent user interface (UI) elements such as verbs, icons, a title, and a header. 开发人员受益GenericWebPart于控件, 因为它使他们能够重复使用 Web 部件应用程序中的现有用户控件和服务器控件。Developers benefit from the GenericWebPart control because it enables them to reuse existing user controls and server controls within Web Parts applications.

备注

创建 Web 部件页面时, 无需执行任何操作即可使现有用户控件或自定义控件与GenericWebPart控件一起包装。When you create Web Parts pages, you do not have to do anything to enable an existing user control or custom control to be wrapped with the GenericWebPart control. 只需以编程方式或通过在页WebPartZoneBase的标记中声明的方式将服务器或用户控件添加到区域, Web 部件控件集就会在运行时自动GenericWebPart使用对象包装控件。Simply add your server or user control to a WebPartZoneBase zone, either programmatically or by declaring it in the page's markup, and the Web Parts control set automatically wraps your control with a GenericWebPart object at run time.

由于放置在区域中WebPartZoneBase的服务器控件在运行时GenericWebPart使用控件进行包装, 因此开发人员可以使用普通的服务器和用户控件, 就像WebPart它们是控件一样。Because server controls that are placed in WebPartZoneBase zones are wrapped with a GenericWebPart control at run time, developers can use ordinary server and user controls exactly as if they were WebPart controls. 请注意, 如果在中声明了Control WebPartZone继承自基类的自定义控件, 这些控件将不支持内部WebPart属性的使用。Note that, if you declare custom controls that inherit from the base Control class within a WebPartZone, these controls cannot support the use of the intrinsic WebPart properties. 因此, 你不能声明IWebPart此类控件的属性, 包括属性和Description属性Title等属性。Thus, you cannot declare the IWebPart properties on such controls, including properties such as the Title property and the Description property. 相反, 其他类型的服务器控件 (如WebPart WebControl继承自的控件、用户控件和自定义控件) 可以声明这些属性, 因为它们支持使用 expando 属性。In contrast, other types of server controls (such as WebPart controls, user controls, and custom controls that inherit from WebControl) can declare these properties, because they support the use of expando properties.

Expando 属性实际上是可以通过IAttributeAccessor接口动态添加到类的字符串。Expando properties are actually strings that can be added to a class dynamically as a property, by means of the IAttributeAccessor interface. 实现此接口的控件 (包括WebControl类及其子级) 可以使用 expando 属性。Controls that implement this interface, including the WebControl class and its children, can use expando properties. 由于基类Control不支持 expando 属性, 因此当ControlWebPartZone类继承的自定义控件置于和在运行时使用GenericWebPart控件进行包装时, Web 部件控件集不能将内部IWebPart属性动态添加到自定义控件。Because the base Control class does not support expando properties, when a custom control that inherits from the Control class is placed in a WebPartZone and wrapped with a GenericWebPart control at run time, the Web Parts control set cannot dynamically add the intrinsic IWebPart properties to the custom control. 在这种情况下, 您有两种选择。You have two choices in this case. 可以在没有IWebPart属性的情况下使用自定义控件, 也可以在IWebPart自定义控件中实现该接口, 使其可以使用这些属性。You can use the custom control without the IWebPart properties, or you can implement the IWebPart interface in the custom control, enabling it to use the properties.

作为从WebControl继承的控件如何IWebPart使用属性的示例, 如果在设计时在页面WebPartZoneBase的标记Calendar中声明了 ASP.NET 控件 (在区域内), 即使此控件不继承从类而不是本机包含WebPart成员, 你仍可以将其WebPart视为完全像控件。 WebPartAs an example of how controls that inherit from WebControl can use the IWebPart properties, if you declare an ASP.NET Calendar control in the markup of a page (within a WebPartZoneBase zone) at design time, even though this control does not inherit from the WebPart class and does not natively contain WebPart members, you can still treat it exactly like a WebPart control. 可以在 calendar WebPart控件上声明属性, Title如、 Description和其他。You can declare WebPart properties on the calendar control, such as Title, Description, and others. 在运行时, 您可以使用GetGenericWebPart方法 (该方法GenericWebPart返回动态包装日历控件的控件), 并以编程方式与使用WebPart控件完全相同的方式进行处理, 并访问所有相同的属性、事件和方法。At run time, you can use the GetGenericWebPart method, which returns the GenericWebPart control that is dynamically wrapping the calendar control, and work with it programmatically exactly as you would with a WebPart control, with access to all the same properties, events, and methods.

控件具有一个关键属性, 可用于访问其基础服务器控件ChildControl : 属性。 GenericWebPartThe GenericWebPart control has a critical property that allows you to access its underlying server control: the ChildControl property. 此属性允许开发人员以编程方式访问服务器控件。This property allows developers to programmatically access the server control. 如果设置了AuthorizationFilter属性, 则WebPartManager控件也使用属性来访问子控件中的个性化设置数据,并执行授权。ChildControlThe ChildControl property is also used by the WebPartManager control to access personalization data from the child control, and to perform authorization, if the AuthorizationFilter property is set.

控件具有多个其他属性, 所有这些属性都重写从基类WebPart继承的属性。 GenericWebPartThe GenericWebPart control has several other properties, all of which override properties inherited from the base WebPart class. 如前所述, 可以将这些属性与任何子控件一起使用, 以便它能够作为WebPart控件。As noted, you can use these properties with any child control, so that it can behave as a WebPart control. 一个重要的ExportMode属性是属性; 它确定是否可以导出所有的可导出属性 (或只是标记为不敏感的属性)。One important property is the ExportMode property; it determines whether all the exportable properties, or only those marked as non-sensitive, can be exported. WebPart从类继承的面向 UI 的属性 ( TitleUrl Title CatalogIconImageUrl如、 Description Height、、、和Width) 可以在任何服务器控件的声明性标记中设置,置于WebPartZoneBase区域中。The UI-oriented properties inherited from the WebPart class, such as CatalogIconImageUrl, Description, Height, Title, TitleUrl, and Width, can be set in the declarative markup for any server control that is placed in a WebPartZoneBase zone.

GenericWebPart类中的重要方法CreateControlCollection包括方法, 该方法创建与GenericWebPart控件关联的控件 (包括子控件) 的集合以及Render方法, 该方法将所有呈现委托给已包装的子控件。Important methods in the GenericWebPart class include the CreateControlCollection method, which creates the collection of controls (including child controls) associated with a GenericWebPart control, and the Render method, which delegates all rendering to the wrapped child controls. GenericWebPart类的构造函数是受保护的, 旨在供内部使用或用于扩展性方案。The constructors on the GenericWebPart class are protected and are intended either for internal use or for extensibility scenarios.

使用GenericWebPart控件有一些更有用的见解。There are some additional helpful insights for working with GenericWebPart controls. 如果要为GenericWebPart类中重写的属性设置默认值, 则用户控件或自定义服务器控件可以IWebPart实现和IWebActionable接口, 并重写它们的成员。If you want to set default values for the overridden properties in the GenericWebPart class, your user control or custom server control can implement the IWebPart and IWebActionable interfaces, and override their members. 在运行时, GenericWebPart控件将从实现接口的子控件获取其实现的属性的值。At run time, the GenericWebPart control will get its values for the implemented properties from the child control that implements the interfaces. 如果控件将其任意属性定义为可个性化的 (通过使用Personalizable metadata 特性), 则GenericWebPart控件将在运行时自动启用这些属性以进行个性化设置, 就像WebPart控件。If your control defines any of its properties as personalizable (by using the Personalizable metadata attribute), the GenericWebPart control automatically enables those properties for personalization at run time, just like the personalizable properties on a WebPart control.

如果要为控件提供 Web 部件编辑功能, 可以实现IWebEditable接口。If you want to provide Web Parts editing features for your control, you can implement the IWebEditable interface. 在运行时, 当调用CreateEditorParts方法时GenericWebPart , WebBrowsableObject属性的控件代码将调用到子控件中的相同属性, 并使用子控件的实现来创建关联的自定义EditorPart控件.At run time, when the CreateEditorParts method is called, the GenericWebPart control's code for the WebBrowsableObject property will call into the same property in the child control, and use the child control's implementation to create associated custom EditorPart controls.

继承者说明

有些情况下, 需要从GenericWebPart类继承。There are few occasions where it is necessary to inherit from the GenericWebPart class. 如果开发人员希望在创建GenericWebPart控件时在构造函数中实现某些自定义操作, 则会出现这种情况。One such case would be if a developer wants to implement some custom action in the constructor when a GenericWebPart control is created. 例如, 你可能想要将子控件存储在GenericWebPart类中除控件集合以外的位置。For example, you might want to store the child control somewhere other than the control collection within the GenericWebPart class. 如果从GenericWebPart类继承, 还需要WebPartManager从类继承并重写其CreateWebPart(Control)方法, 以使其能够创建自定义控件。If you inherit from the GenericWebPart class, you also need to inherit from the WebPartManager class and override its CreateWebPart(Control) method to enable it to create your custom control.

构造函数

GenericWebPart(Control)

通过传入对成为子控件的控件的引用来初始化 GenericWebPart 控件的新实例。Initializes a new instance of a GenericWebPart control by passing in a reference to a control that becomes the child control.

属性

AccessKey

获取或设置使您得以快速导航到 Web 服务器控件的访问键。Gets or sets the access key that allows you to quickly navigate to the Web server control.

(继承自 WebControl)
Adapter

获取控件的浏览器特定适配器。Gets the browser-specific adapter for the control.

(继承自 Control)
AllowClose

获取或设置一个值,该值指示最终用户是否可以在网页上关闭 WebPart 控件。Gets or sets a value indicating whether an end user can close a WebPart control on a Web page.

(继承自 WebPart)
AllowConnect

获取或设置一个值,该值指示 WebPart 控件是否允许其他控件与之形成连接。Gets or sets a value that indicates whether the WebPart control allows other controls to form connections with it.

(继承自 WebPart)
AllowEdit

获取或设置一个值,该值指示最终用户是否可以通过一个或多个 WebPart 控件提供的用户界面 (UI) 修改 EditorPart 控件。Gets or sets a value indicating whether an end user can modify a WebPart control through the user interface (UI) provided by one or more EditorPart controls.

(继承自 WebPart)
AllowHide

获取或设置一个值,该值指示是否允许最终用户隐藏 WebPart 控件。Gets or sets a value indicating whether end users are allowed to hide a WebPart control.

(继承自 WebPart)
AllowMinimize

获取或设置一个值,该值指示最终用户是否可以最小化 WebPart 控件。Gets or sets a value indicating whether end users can minimize a WebPart control.

(继承自 WebPart)
AllowZoneChange

获取或设置一个值,该值指示用户是否可以在两个 WebPart 区域之间移动 WebPartZoneBase 控件。Gets or sets a value indicating whether a user can move a WebPart control between WebPartZoneBase zones.

(继承自 WebPart)
AppRelativeTemplateSourceDirectory

获取或设置包含该控件的 PageUserControl 对象的应用程序相对虚拟目录。Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(继承自 Control)
Attributes

获取与控件的特性不对应的任意特性(只用于呈现)的集合。Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(继承自 WebControl)
AuthorizationFilter

获取或设置一个任意字符串,以确定 WebPart 控件是否已被授权添加至页中。Gets or sets an arbitrary string to determine whether a WebPart control is authorized to be added to a page.

(继承自 WebPart)
BackColor

获取或设置 Web 服务器控件的背景色。Gets or sets the background color of the Web server control.

(继承自 WebControl)
BackImageUrl

获取或设置面板控件背景图像的 URL。Gets or sets the URL of the background image for the panel control.

(继承自 Panel)
BindingContainer

获取包含该控件的数据绑定的控件。Gets the control that contains this control's data binding.

(继承自 Control)
BorderColor

获取或设置 Web 控件的边框颜色。Gets or sets the border color of the Web control.

(继承自 WebControl)
BorderStyle

获取或设置 Web 服务器控件的边框样式。Gets or sets the border style of the Web server control.

(继承自 WebControl)
BorderWidth

获取或设置 Web 服务器控件的边框宽度。Gets or sets the border width of the Web server control.

(继承自 WebControl)
CatalogIconImageUrl

获取或设置图像的 URL,该图像在控件目录中表示一个 GenericWebPart 控件。Gets or sets the URL to an image that represents a GenericWebPart control in a catalog of controls.

ChildControl

获取对子控件的引用,该子控件在运行时将由 GenericWebPart 控件包装。Gets a reference to the child control that is wrapped by a GenericWebPart control at run time.

ChildControlsCreated

获取一个值,该值指示是否已创建服务器控件的子控件。Gets a value that indicates whether the server control's child controls have been created.

(继承自 Control)
ChromeState

获取或设置部件控件是处于最小化状态还是正常状态。Gets or sets whether a part control is in a minimized or normal state.

(继承自 WebPart)
ChromeType

获取或设置构成 Web 部件控件的框架的边框类型。Gets or sets the type of border that frames a Web Parts control.

(继承自 WebPart)
ClientID

获取由 ASP.NET 生成的 HTML 标记的控件 ID。Gets the control ID for HTML markup that is generated by ASP.NET.

(继承自 Control)
ClientIDMode

获取或设置用于生成 ClientID 属性值的算法。Gets or sets the algorithm that is used to generate the value of the ClientID property.

(继承自 Control)
ClientIDSeparator

获取一个字符值,该值表示 ClientID 属性中使用的分隔符字符。Gets a character value representing the separator character used in the ClientID property.

(继承自 Control)
ConnectErrorMessage

获取在连接过程中发生错误时要向用户显示的错误消息。Gets an error message to display to users if errors occur during the connection process.

(继承自 WebPart)
Context

为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。Gets the HttpContext object associated with the server control for the current Web request.

(继承自 Control)
Controls

获取 ControlCollection 对象,该对象包含用户界面层次结构中指定服务器控件的子控件。Gets a ControlCollection object that contains the child controls for a specified server control in the user interface hierarchy.

(继承自 Part)
ControlStyle

获取 Web 服务器控件的样式。Gets the style of the Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebControl)
ControlStyleCreated

获取一个值,该值指示是否已为 Style 属性创建了 ControlStyle 对象。Gets a value indicating whether a Style object has been created for the ControlStyle property. 此属性主要由控件开发人员使用。This property is primarily used by control developers.

(继承自 WebControl)
CssClass

获取或设置由 Web 服务器控件在客户端呈现的级联样式表 (CSS) 类。Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(继承自 WebControl)
DataItemContainer

如果命名容器实现 IDataItemContainer,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataItemContainer.

(继承自 Control)
DataKeysContainer

如果命名容器实现 IDataKeysControl,则获取对命名容器的引用。Gets a reference to the naming container if the naming container implements IDataKeysControl.

(继承自 Control)
DefaultButton

获取或设置 Panel 控件中包含的默认按钮的标识符。Gets or sets the identifier for the default button that is contained in the Panel control.

(继承自 Panel)
Description

获取或设置一条短语,该短语在服务器控件的工具提示和目录中用来概述该控件的作用。Gets or sets a brief phrase that summarizes what a control does, for use in ToolTips and catalogs of server controls.

DesignMode

获取一个值,该值指示是否正在使用设计图面上的一个控件。Gets a value indicating whether a control is being used on a design surface.

(继承自 Control)
Direction

获取或设置内容在控件中流动的水平方向。Gets or sets the horizontal direction that content flows within the control.

(继承自 WebPart)
DisplayTitle

获取一个字符串,其中包含在 WebPart 控件实例的标题栏中实际显示的完整标题文本。Gets a string that contains the full title text actually displayed in the title bar of a WebPart control instance.

(继承自 WebPart)
Enabled

获取或设置一个值,该值指示是否启用 Web 服务器控件。Gets or sets a value indicating whether the Web server control is enabled.

(继承自 WebControl)
EnableTheming

获取或设置一个值,该值指示主题是否应用于该控件。Gets or sets a value indicating whether themes apply to this control.

(继承自 WebControl)
EnableViewState

获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(继承自 Control)
Events

获取控件的事件处理程序委托列表。Gets a list of event handler delegates for the control. 此属性为只读。This property is read-only.

(继承自 Control)
ExportMode

获取或设置是否可以导出所有、某些 WebPart 控件属性或不能导出该控件的任何属性。Gets or sets whether all, some, or none of a WebPart control's properties can be exported.

(继承自 WebPart)
Font

获取与 Web 服务器控件关联的字体属性。Gets the font properties associated with the Web server control.

(继承自 WebControl)
ForeColor

获取或设置 Web 服务器控件的前景色(通常是文本颜色)。Gets or sets the foreground color (typically the color of the text) of the Web server control.

(继承自 WebControl)
GroupingText

获取或设置面板控件中包含的控件组的标题。Gets or sets the caption for the group of controls that is contained in the panel control.

(继承自 Panel)
HasAttributes

获取一个值,该值指示控件是否具有特性集。Gets a value indicating whether the control has attributes set.

(继承自 WebControl)
HasChildViewState

获取一个值,该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(继承自 Control)
HasSharedData

获取一个值,该值指示 WebPart 控件是否有与之关联的任何共享个性化数据。Gets a value that indicates whether a WebPart control has any shared personalization data associated with it.

(继承自 WebPart)
HasUserData

获取一个值,该值指示 WebPart 控件是否有与之关联的任何用户个性化数据。Gets a value that indicates whether a WebPart control has any user personalization data associated with it.

(继承自 WebPart)
Height

获取或设置控件的高度(以像素为单位)。Gets or sets the height (in pixels) of a control.

HelpMode

获取或设置用于显示 WebPart 控件的帮助内容的用户界面 (UI) 的类型。Gets or sets the type of user interface (UI) used to display Help content for a WebPart control.

(继承自 WebPart)
HelpUrl

获取或设置指向 WebPart 控件的帮助文件的 URL。Gets or sets the URL to a Help file for a WebPart control.

(继承自 WebPart)
Hidden

获取或设置一个值,该值指示是否在网页上显示 WebPart 控件。Gets or sets a value indicating whether a WebPart control is displayed on a Web page.

(继承自 WebPart)
HorizontalAlign

获取或设置面板内容的水平对齐方式。Gets or sets the horizontal alignment of the contents within the panel.

(继承自 Panel)
ID

获取或设置控件的 ID。Gets or sets the ID of a control. 此值是不可继承的。This value is not inheritable.

IdSeparator

获取用于分隔控件标识符的字符。Gets the character used to separate control identifiers.

(继承自 Control)
ImportErrorMessage

获取或设置在导入 WebPart 控件时发生错误的情况下将显示的错误消息。Gets or sets an error message that is used if errors occur when a WebPart control is imported.

(继承自 WebPart)
IsChildControlStateCleared

获取一个值,该值指示该控件中包含的控件是否具有控件状态。Gets a value indicating whether controls contained within this control have control state.

(继承自 Control)
IsClosed

获取一个值,该值指示 WebPart 控件当前在 Web 部件页上是否已关闭。Gets a value that indicates whether a WebPart control is currently closed on a Web Parts page.

(继承自 WebPart)
IsEnabled

获取一个值,该值指示是否启用控件。Gets a value indicating whether the control is enabled.

(继承自 WebControl)
IsShared

获取一个值,该值指示 WebPart 控件是否为共享控件,即对 Web 部件页的所有用户都可见。Gets a value that indicates whether a WebPart control is shared, meaning that it is visible to all users of a Web Parts page.

(继承自 WebPart)
IsStandalone

获取一个值,该值指示 WebPart 控件是否是独立控件(即该控件不包含在 WebPartZoneBase 区域中)。Gets a value that indicates whether a WebPart control is standalone, meaning that it is not contained within a WebPartZoneBase zone.

(继承自 WebPart)
IsStatic

获取一个值,该值指示 WebPart 控件是否为静态控件,即控件在 Web 部件页的标记中声明,而不是通过编程方式添加至页中。Gets a value that indicates whether a WebPart control is a static control, which means the control is declared in the markup of a Web Parts page and not added to the page programmatically.

(继承自 WebPart)
IsTrackingViewState

获取一个值,用于指示服务器控件是否会将更改保存到其视图状态中。Gets a value that indicates whether the server control is saving changes to its view state.

(继承自 Control)
IsViewStateEnabled

获取一个值,该值指示是否为该控件启用了视图状态。Gets a value indicating whether view state is enabled for this control.

(继承自 Control)
LoadViewStateByID

获取一个值,该值指示控件是否通过 ID 而不是索引参与加载其视图状态。Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(继承自 Control)
NamingContainer

获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 ID 属性值的服务器控件。Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(继承自 Control)
Page

获取对包含服务器控件的 Page 实例的引用。Gets a reference to the Page instance that contains the server control.

(继承自 Control)
Parent

获取对页 UI 层次结构中服务器控件的父控件的引用。Gets a reference to the server control's parent control in the page control hierarchy.

(继承自 Control)
RenderingCompatibility

获取一个值,该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(继承自 Control)
ScrollBars

获取或设置 Panel 控件中滚动条的可见性和位置。Gets or sets the visibility and position of scroll bars in a Panel control.

(继承自 Panel)
Site

获取容器信息,该容器在呈现于设计图面上时承载当前控件。Gets information about the container that hosts the current control when rendered on a design surface.

(继承自 Control)
SkinID

获取或设置要应用于控件的外观。Gets or sets the skin to apply to the control.

(继承自 WebControl)
Style

获取将在 Web 服务器控件的外部标记上呈现为样式特性的文本特性的集合。Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(继承自 WebControl)
Subtitle

获取一个字符串,该字符串与 Title 属性值连接即形成控件的完整标题。Gets a string that is concatenated with the Title property value to form a complete title for a control.

SupportsDisabledAttribute

获取一个值,该值指示在控件的 disabled 属性为 IsEnabled 时,控件是否应将呈现的 HTML 元素的 false 特性设置为 "disabled"。Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(继承自 Panel)
TabIndex

获取或设置 Web 服务器控件的选项卡索引。Gets or sets the tab index of the Web server control.

(继承自 WebControl)
TagKey

获取对应于此 Web 服务器控件的 HtmlTextWriterTag 值。Gets the HtmlTextWriterTag value that corresponds to this Web server control. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebControl)
TagName

获取控件标记的名称。Gets the name of the control tag. 此属性主要由控件开发人员使用。This property is used primarily by control developers.

(继承自 WebControl)
TemplateControl

获取或设置对包含该控件的模板的引用。Gets or sets a reference to the template that contains this control.

(继承自 Control)
TemplateSourceDirectory

获取包含当前服务器控件的 PageUserControl 的虚拟目录。Gets the virtual directory of the Page or UserControl that contains the current server control.

(继承自 Control)
Title

获取或设置 GenericWebPart 控件的标题。Gets or sets the title of a GenericWebPart control.

TitleIconImageUrl

获取或设置图像的 URL,该图像用于在 GenericWebPart 控件自身的标题栏中表示该控件。Gets or sets the URL to an image used to represent a GenericWebPart control in the control's own title bar.

TitleUrl

获取或设置有关 GenericWebPart 控件补充信息的 URL。Gets or sets a URL to supplemental information about a GenericWebPart control.

ToolTip

获取或设置当鼠标指针悬停在 Web 服务器控件上时显示的文本。Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(继承自 WebControl)
UniqueID

获取服务器控件的唯一的、以分层形式限定的标识符。Gets the unique, hierarchically qualified identifier for the server control.

(继承自 Control)
ValidateRequestMode

获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(继承自 Control)
Verbs

获取与 GenericWebPart 控件关联的自定义谓词的集合。Gets a collection of custom verbs associated with a GenericWebPart control.

ViewState

获取状态信息的字典,这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(继承自 Control)
ViewStateIgnoresCase

获取一个值,该值指示 StateBag 对象是否不区分大小写。Gets a value that indicates whether the StateBag object is case-insensitive.

(继承自 Control)
ViewStateMode

获取或设置此控件的视图状态模式。Gets or sets the view-state mode of this control.

(继承自 Control)
Visible

获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上。Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(继承自 Control)
WebBrowsableObject

获取对子控件的引用,以使该控件可由自定义 EditorPart 控件进行编辑。Gets a reference to the child control, to enable the control to be edited by custom EditorPart controls.

WebPartManager

获取对与 WebPartManager 控件实例关联的 WebPart 控件的引用。Gets a reference to the WebPartManager control associated with a WebPart control instance.

(继承自 WebPart)
Width

获取或设置控件的宽度(以像素为单位)。Gets or sets the width (in pixels) of the control.

Wrap

获取或设置一个指示面板中的内容是否换行的值。Gets or sets a value indicating whether the content wraps within the panel.

(继承自 Panel)
Zone

获取当前包含 WebPartZoneBase 控件的 WebPart 区域。Gets the WebPartZoneBase zone that currently contains a WebPart control.

(继承自 WebPart)
ZoneIndex

获取 WebPart 控件在其区域内的索引位置。Gets the index position of a WebPart control within its zone.

(继承自 WebPart)

方法

AddAttributesToRender(HtmlTextWriter)

将有关背景图像、对齐方式、换行和方向的信息添加到特性列表以进行呈现。Adds information about the background image, alignment, wrap, and direction to the list of attributes to render.

(继承自 Panel)
AddedControl(Control, Int32)

在子控件添加到 Controls 对象的 Control 集合后调用。Called after a child control is added to the Controls collection of the Control object.

(继承自 Control)
AddParsedSubObject(Object)

通知服务器控件,分析了一个元素(XML 或 HTML),并将该元素添加到服务器控件的 ControlCollection 对象中。Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(继承自 Control)
ApplyStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,覆盖控件的所有现有的样式元素。Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. 此方法主要由控件开发人员使用。This method is primarily used by control developers.

(继承自 WebControl)
ApplyStyleSheetSkin(Page)

将页样式表中定义的样式属性应用到控件。Applies the style properties defined in the page style sheet to the control.

(继承自 Control)
BeginRenderTracing(TextWriter, Object)

开始输出数据的设计时追踪。Begins design-time tracing of rendering data.

(继承自 Control)
BuildProfileTree(String, Boolean)

收集有关服务器控件的信息并将该信息发送到 Trace 属性,在启用页的跟踪功能时将显示该属性。Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(继承自 Control)
ClearCachedClientID()

将缓存的 ClientID 值设置为 nullSets the cached ClientID value to null.

(继承自 Control)
ClearChildControlState()

删除服务器控件的子控件的控件状态信息。Deletes the control-state information for the server control's child controls.

(继承自 Control)
ClearChildState()

删除服务器控件的所有子控件的视图状态和控件状态信息。Deletes the view-state and control-state information for all the server control's child controls.

(继承自 Control)
ClearChildViewState()

删除服务器控件的所有子控件的视图状态信息。Deletes the view-state information for all the server control's child controls.

(继承自 Control)
ClearEffectiveClientIDMode()

将当前控件实例和任何子控件的 ClientIDMode 属性设置为 InheritSets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(继承自 Control)
CopyBaseAttributes(WebControl)

Style 对象未封装的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
CreateChildControls()

由 ASP.NET 页框架调用,以通知服务器控件在准备回发或呈现时使用基于撰写的实现来创建其所包含任何子控件。Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

CreateControlCollection()

重写基方法,以创建由 GenericWebPart 控件所包装的子控件组成的只读集合。Overrides the base method to create a read-only collection that consists of the child control wrapped by a GenericWebPart control.

CreateControlStyle()

创建由 Panel 控件在内部用来实现所有与样式有关的属性的样式对象。Creates a style object that is used internally by the Panel control to implement all style related properties.

(继承自 Panel)
CreateEditorParts()

返回自定义 EditorPart 控件的集合,这些控件可用于在 GenericWebPart 控件的子控件处于编辑模式时对其进行编辑。Returns a collection of custom EditorPart controls that can be used to edit the child control of a GenericWebPart control when it is in edit mode.

DataBind()

将数据源绑定到调用的服务器控件及其所有子控件。Binds a data source to the invoked server control and all its child controls.

(继承自 Part)
DataBind(Boolean)

将数据源绑定到调用的服务器控件及其所有子控件,同时可以选择引发 DataBinding 事件。Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(继承自 Control)
DataBindChildren()

将数据源绑定到服务器控件的子控件。Binds a data source to the server control's child controls.

(继承自 Control)
Dispose()

使服务器控件得以在从内存中释放之前执行最后的清理操作。Enables a server control to perform final clean up before it is released from memory.

(继承自 Control)
EndRenderTracing(TextWriter, Object)

结束输出数据的设计时追踪。Ends design-time tracing of rendering data.

(继承自 Control)
EnsureChildControls()

确定服务器控件是否包含子控件。Determines whether the server control contains child controls. 如果不包含,则创建子控件。If it does not, it creates child controls.

(继承自 Control)
EnsureID()

为尚未分配标识符的控件创建标识符。Creates an identifier for controls that do not have an identifier assigned.

(继承自 Control)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
FindControl(String)

在当前的命名容器中搜索带指定 id 参数的服务器控件。Searches the current naming container for a server control with the specified id parameter.

(继承自 Control)
FindControl(String, Int32)

使用指定的 idpathOffset 参数(该参数有助于搜索)中指定的整数在当前命名容器中搜索服务器控件。Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. 不应重写此版本的 FindControl 方法。You should not override this version of the FindControl method.

(继承自 Control)
Focus()

为控件设置输入焦点。Sets input focus to a control.

(继承自 Control)
GetDesignModeState()

获取控件的设计时数据。Gets design-time data for a control.

(继承自 Control)
GetHashCode()

用作默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetRouteUrl(Object)

获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters.

(继承自 Control)
GetRouteUrl(RouteValueDictionary)

获取与一组路由参数对应的 URL。Gets the URL that corresponds to a set of route parameters.

(继承自 Control)
GetRouteUrl(String, Object)

获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name.

(继承自 Control)
GetRouteUrl(String, RouteValueDictionary)

获取与一组路由参数以及某个路由名称对应的 URL。Gets the URL that corresponds to a set of route parameters and a route name.

(继承自 Control)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
GetUniqueIDRelativeTo(Control)

返回指定控件的 UniqueID 属性的前缀部分。Returns the prefixed portion of the UniqueID property of the specified control.

(继承自 Control)
HasControls()

确定服务器控件是否包含任何子控件。Determines if the server control contains any child controls.

(继承自 Control)
HasEvents()

返回一个值,该值指示是否为控件或任何子控件注册事件。Returns a value indicating whether events are registered for the control or any child controls.

(继承自 Control)
IsLiteralContent()

确定服务器控件是否只包含文字内容。Determines if the server control holds only literal content.

(继承自 Control)
LoadControlState(Object)

SaveControlState() 方法保存的上一个页请求还原控件状态信息。Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(继承自 Control)
LoadViewState(Object)

从使用 SaveViewState() 方法保存的前一请求还原视图状态信息。Restores view-state information from a previous request that was saved with the SaveViewState() method.

(继承自 WebControl)
MapPathSecure(String)

检索虚拟路径(绝对的或相对的)映射到的物理路径。Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(继承自 Control)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
MergeStyle(Style)

将指定样式的所有非空白元素复制到 Web 控件,但不覆盖该控件现有的任何样式元素。Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
OnBubbleEvent(Object, EventArgs)

确定服务器控件的事件是否沿页的 UI 服务器控件层次结构向上传递。Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(继承自 Control)
OnClosing(EventArgs)

启用派生类,以在 Web 部件页中关闭 WebPart 控件时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is closed on a Web Parts page.

(继承自 WebPart)
OnConnectModeChanged(EventArgs)

启用派生类,以在 WebPart 控件开始或结束与其他控件的连接过程时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is beginning or ending the process of connecting to other controls.

(继承自 WebPart)
OnDataBinding(EventArgs)

引发 DataBinding 事件。Raises the DataBinding event.

(继承自 Control)
OnDeleting(EventArgs)

启用派生类,以在从 Web 部件页中永久移除 WebPart 控件时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is permanently removed from a Web Parts page.

(继承自 WebPart)
OnEditModeChanged(EventArgs)

启用派生类,以在 WebPart 控件进入或离开编辑模式时提供自定义处理。Enables derived classes to provide custom handling when a WebPart control is entering or leaving edit mode.

(继承自 WebPart)
OnInit(EventArgs)

引发 Init 事件。Raises the Init event.

(继承自 Control)
OnLoad(EventArgs)

引发 Load 事件。Raises the Load event.

(继承自 Control)
OnPreRender(EventArgs)

引发 PreRender 事件。Raises the PreRender event.

(继承自 Control)
OnUnload(EventArgs)

引发 Unload 事件。Raises the Unload event.

(继承自 Control)
OpenFile(String)

获取用于读取文件的 StreamGets a Stream used to read a file.

(继承自 Control)
RaiseBubbleEvent(Object, EventArgs)

将所有事件源及其信息分配给控件的父级。Assigns any sources of the event and its information to the control's parent.

(继承自 Control)
RemovedControl(Control)

Controls 对象的 Control 集合移除子控件后调用。Called after a child control is removed from the Controls collection of the Control object.

(继承自 Control)
Render(HtmlTextWriter)

将对控件内容的呈现委托给子控件。Delegates rendering the contents of the control to the child control.

RenderBeginTag(HtmlTextWriter)

Panel 控件的 HTML 开始标记呈现到指定的编写器中。Renders the HTML opening tag of the Panel control to the specified writer.

(继承自 Panel)
RenderChildren(HtmlTextWriter)

将服务器控件子级的内容输出到提供的 HtmlTextWriter 对象,该对象可写入要在客户端上呈现的内容。Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(继承自 Control)
RenderContents(HtmlTextWriter)

将控件的内容呈现到指定的编写器中。Renders the contents of the control to the specified writer. 此方法主要由控件开发人员使用。This method is used primarily by control developers.

(继承自 WebControl)
RenderControl(HtmlTextWriter)

将服务器控件内容输出到所提供的 HtmlTextWriter 对象,如果启用了跟踪,则还将存储有关该控件的跟踪信息。Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(继承自 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 对象将服务器控件内容输出到提供的 ControlAdapter 对象。Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(继承自 Control)
RenderEndTag(HtmlTextWriter)

Panel 控件的 HTML 结束标记呈现到指定的编写器中。Renders the HTML closing tag of the Panel control into the specified writer.

(继承自 Panel)
ResolveAdapter()

获取负责呈现指定控件的控件适配器。Gets the control adapter responsible for rendering the specified control.

(继承自 Control)
ResolveClientUrl(String)

获取浏览器可以使用的 URL。Gets a URL that can be used by the browser.

(继承自 Control)
ResolveUrl(String)

将 URL 转换为在请求客户端可用的 URL。Converts a URL into one that is usable on the requesting client.

(继承自 Control)
SaveControlState()

保存将页面回发到服务器之后发生的所有服务器控件状态更改。Saves any server control state changes that have occurred since the time the page was posted back to the server.

(继承自 Control)
SaveViewState()

保存调用 TrackViewState() 方法后修改的任何状态。Saves any state that was modified after the TrackViewState() method was invoked.

(继承自 WebControl)
SetDesignModeState(IDictionary)

为控件设置设计时数据。Sets design-time data for a control.

(继承自 Control)
SetPersonalizationDirty()

设置一个标志,以指示当前 WebPart 控件实例的个性化数据已更改。Sets a flag indicating that personalization data has changed for the current WebPart control instance.

(继承自 WebPart)
SetRenderMethodDelegate(RenderMethod)

分配事件处理程序委托,以将服务器控件及其内容呈现到父控件中。Assigns an event handler delegate to render the server control and its content into its parent control.

(继承自 Control)
SetTraceData(Object, Object)

使用跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(继承自 Control)
SetTraceData(Object, Object, Object)

使用跟踪对象、跟踪数据键和跟踪数据值,为呈现数据的设计时追踪设置跟踪数据。Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(继承自 Control)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)
TrackViewState()

使控件跟踪其视图状态的更改,以便将这些更改存储在对象的 ViewState 属性中。Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(继承自 WebPart)

事件

DataBinding

当服务器控件绑定到数据源时发生。Occurs when the server control binds to a data source.

(继承自 Control)
Disposed

当从内存释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生存期的最后阶段。Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(继承自 Control)
Init

当服务器控件初始化时发生;初始化是控件生存期的第一步。Occurs when the server control is initialized, which is the first step in its lifecycle.

(继承自 Control)
Load

当服务器控件加载到 Page 对象中时发生。Occurs when the server control is loaded into the Page object.

(继承自 Control)
PreRender

在加载 Control 对象之后、呈现之前发生。Occurs after the Control object is loaded but prior to rendering.

(继承自 Control)
Unload

当服务器控件从内存中卸载时发生。Occurs when the server control is unloaded from memory.

(继承自 Control)

显式接口实现

IAttributeAccessor.GetAttribute(String)

获取具有指定名称的 Web 控件的特性。Gets an attribute of the Web control with the specified name.

(继承自 WebControl)
IAttributeAccessor.SetAttribute(String, String)

将 Web 控件的特性设置为指定的名称和值。Sets an attribute of the Web control to the specified name and value.

(继承自 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

允许复合部件控件设计器的开发人员在设计图面上重新创建控件的子控件。Allows the developer of a designer for a composite part control to recreate the control's child controls on the design surface.

(继承自 Part)
IControlBuilderAccessor.ControlBuilder

有关此成员的说明,请参阅 ControlBuilderFor a description of this member, see ControlBuilder.

(继承自 Control)
IControlDesignerAccessor.GetDesignModeState()

有关此成员的说明,请参阅 GetDesignModeState()For a description of this member, see GetDesignModeState().

(继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

有关此成员的说明,请参阅 SetDesignModeState(IDictionary)For a description of this member, see SetDesignModeState(IDictionary).

(继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

有关此成员的说明,请参阅 SetOwnerControl(Control)For a description of this member, see SetOwnerControl(Control).

(继承自 Control)
IControlDesignerAccessor.UserData

有关此成员的说明,请参阅 UserDataFor a description of this member, see UserData.

(继承自 Control)
IDataBindingsAccessor.DataBindings

有关此成员的说明,请参阅 DataBindingsFor a description of this member, see DataBindings.

(继承自 Control)
IDataBindingsAccessor.HasDataBindings

有关此成员的说明,请参阅 HasDataBindingsFor a description of this member, see HasDataBindings.

(继承自 Control)
IExpressionsAccessor.Expressions

有关此成员的说明,请参阅 ExpressionsFor a description of this member, see Expressions.

(继承自 Control)
IExpressionsAccessor.HasExpressions

有关此成员的说明,请参阅 HasExpressionsFor a description of this member, see HasExpressions.

(继承自 Control)
IParserAccessor.AddParsedSubObject(Object)

有关此成员的说明,请参阅 AddParsedSubObject(Object)For a description of this member, see AddParsedSubObject(Object).

(继承自 Control)

扩展方法

FindDataSourceControl(Control)

返回与指定控件的数据控件关联的数据源。Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

返回指定控件的命名容器中指定列的字段模板。Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

返回包含数据控件的元表对象。Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

为指定数据控件获取默认值的集合。Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

为指定数据控件获取表元数据。Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

为指定数据控件设置表元数据。Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

为指定数据控件设置表元数据和默认值映射。Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

确定表元数据是否可用。Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

为指定数据控件启用动态数据行为。Enables Dynamic Data behavior for the specified data control.

适用于

另请参阅