使用英语阅读

通过

WebPart.AllowClose 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

获取或设置一个值，该值指示最终用户是否可以在网页上关闭 WebPart 控件。

[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)]
public virtual bool AllowClose { get; set; }

属性值

Boolean

如果可以在网页关闭该控件，则为 true；否则为 false。 默认值是 true。

属性
ThemeableAttribute PersonalizableAttribute

示例

下面的代码示例演示如何更改自定义WebPart控件的 属性的AllowClose默认设置，使其无法关闭。

此示例的第一部分包含名为 的TextDisplayWebPart自定义WebPart控件的代码。 请注意，在自定义控件的构造函数中， TextDisplayWebPart.AllowClose 属性设置为 false，这可以防止用户在网页上关闭控件。 这意味着将为用户禁用控件谓词菜单上的关闭谓词。 若要运行代码示例，必须编译此源代码。 可以显式编译它，并将生成的程序集放入网站的 Bin 文件夹或全局程序集缓存中。 或者，可以将源代码放入站点的“App_Code”文件夹中，并在运行时动态编译源代码。 此代码示例假定将源代码编译为程序集，将其放在 Web 应用程序的 Bin 子文件夹中，并使用网页中的 指令引用程序集 Register 。 有关演示这两种编译方法的演练，请参阅 演练：开发和使用自定义 Web 服务器控件。

using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
    Level=AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
      ChildControlsCreated = true;
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

该示例的第二部分演示如何在 ASP.NET 网页中引用 TextDisplayWebPart 控件。 请注意，在 <aspSample:TextDisplayWebPart> 引用 控件的 元素中，还可以更改控件的构造函数设置的属性的值。 若要允许关闭控件，只需将 属性 AllowClose="true" 添加到声明性标记中的 元素。

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>

<!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>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

注解

用户关闭网页上的 WebPart 控件后，该控件在页面上不再可见或可用。 关闭的控件将添加到页面目录，这是一个 Web 部件实体，用于存储对控件的引用。 如果开发人员将控件添加到 PageCatalogPart 控件中的 CatalogZone 页面，则用户能够将页面切换到目录显示模式，在页面目录中选择关闭的控件，然后将其添加回页面。

备注

WebPart当页面处于目录显示模式时，可以通过编程方式或从页面目录中选择已关闭控件的用户将关闭的控件添加回页面。

WebPart关闭控件与删除控件不同。 关闭的控件可以添加回页面，而已删除的控件将被永久删除。 有关删除控件的详细信息，请参阅 DeleteWebPart 方法。 关闭控件也不同于隐藏控件。 隐藏的控件仍存在于页面上，仍参与页面生命周期事件，并且仅在用户视图中隐藏，但关闭的控件甚至不会在页面上呈现。

静态和动态 WebPart 控件 (静态控件在页面标记中声明，而动态控件则以编程方式添加，) 可以关闭。

如果开发人员将 AllowClose 属性设置为 false，则控件上不会显示关闭谓词，并且用户无法关闭控件。

无法通过主题或样式表主题设置此属性。 有关详细信息，请参阅 ThemeableAttribute 和 ASP.NET 主题和外观。

此属性的个性化设置范围设置为 Shared ，并且只能由授权用户修改。 有关详细信息，请参阅 PersonalizableAttribute 和 Web 部件个性化概述。

适用于

产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅