WebPart.AllowClose Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu určující, zda koncový uživatel může zavřít WebPart ovládací prvek na webové stránce.

public:
 virtual property bool AllowClose { bool get(); void set(bool value); };

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

[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)>]
member this.AllowClose : bool with get, set

Public Overridable Property AllowClose As Boolean

Hodnota vlastnosti

Boolean

truepokud lze ovládací prvek zavřít na webové stránce; v opačném případě . false Výchozí hodnota je true.

Atributy: ThemeableAttribute PersonalizableAttribute

Příklady

Následující příklad kódu ukazuje, jak změnit výchozí nastavení AllowClose vlastnosti pro vlastní WebPart ovládací prvek, aby ho nelze zavřít.

První část tohoto příkladu obsahuje kód vlastního WebPart ovládacího prvku s názvem TextDisplayWebPart. Všimněte si, TextDisplayWebPart.AllowClose že v konstruktoru vlastního ovládacího prvku je vlastnost nastavena na false, která má vliv na zabránění uživatelům zavřít ovládací prvek na webové stránce. To znamená, že pro uživatele bude zakázána podrobná slovesa v nabídce příkazů ovládacího prvku. Abyste mohli spustit příklad kódu, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a výsledné sestavení umístit do složky Bin vašeho webu nebo do globální mezipaměti sestavení. Případně můžete zdrojový kód umístit do složky App_Code webu, kde bude dynamicky kompilován za běhu. Tento příklad kódu předpokládá, že zdrojový kód zkompilujete do sestavení, umístíte ho do podsložky Bin webové aplikace a odkazujete na sestavení pomocí direktivy Register na webové stránce. Návod, který ukazuje obě metody kompilace, najdete v tématu Návod: Vývoj a použití vlastního ovládacího prvku webového serveru.

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;
      }
    }
  }
}

Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        input = New TextBox()
        Me.Controls.Add(input)
        Dim update As New Button()
        update.Text = "Set Label Content"
        AddHandler update.Click, AddressOf Me.submit_Click
        Me.Controls.Add(update)
        ChildControlsCreated = True
    
    End Sub
    
    
    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs) 
        ' Update the label string.
        If input.Text <> String.Empty Then
            _contentText = input.Text & "<br />"
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

Druhá část příkladu ukazuje, jak odkazovat na TextDisplayWebPart ovládací prvek na webové stránce ASP.NET. Všimněte si, že v elementu <aspSample:TextDisplayWebPart> , který odkazuje na ovládací prvek, můžete také změnit hodnotu vlastnosti nastavené konstruktorem ovládacího prvku. Chcete-li povolit zavření ovládacího prvku, jednoduše přidejte AllowClose="true" atribut do prvku v deklarativním kódu.

<%@ 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>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

<!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>

Poznámky

Jakmile uživatel zavře WebPart ovládací prvek na webové stránce, ovládací prvek už není viditelný nebo dostupný na stránce. Uzavřený ovládací prvek se přidá do katalogu stránek, Webové části entita, která ukládá odkaz na ovládací prvek. Pokud vývojář přidá PageCatalogPart ovládací prvek na stránku v rámci CatalogZone ovládacího prvku, uživatelé můžou přepnout stránku do režimu zobrazení katalogu, vybrat zavřený ovládací prvek v katalogu stránek a přidat ho zpět na stránku.

Poznámka

Uzavřený WebPart ovládací prvek lze přidat zpět na stránku prostřednictvím kódu programu nebo uživatelem, který vybere zavřený ovládací prvek z katalogu, když je stránka v režimu zobrazení katalogu.

WebPart Zavření ovládacího prvku se liší od jeho odstranění. Uzavřený ovládací prvek lze přidat zpět na stránku, zatímco odstraněný ovládací prvek je trvale odebrán. Další informace o odstraňování ovládacích prvků najdete v metodě DeleteWebPart . Zavření ovládacího prvku se také liší od skrytí ovládacího prvku. Ovládací prvek, který je skrytý, se stále nachází na stránce, stále se účastní událostí životního cyklu stránky a je skrytý pouze v zobrazení uživatele, ale uzavřený ovládací prvek se ani nezobrazuje na stránce.

Statické i dynamické WebPart ovládací prvky (statické ovládací prvky jsou deklarovány ve značkách stránky, zatímco dynamické ovládací prvky se přidávají programově) je možné zavřít.

Pokud vývojář nastaví AllowClose vlastnost na false, příkaz zavřít se nezobrazí na ovládacím prvku a uživatel nemůže ovládací prvek zavřít.

Tuto vlastnost nelze nastavit motivy nebo motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Obor přizpůsobení této vlastnosti je nastavený na Shared a lze ho upravit pouze autorizovanými uživateli. Další informace najdete v tématu PersonalizableAttribute a Webové části Přehled přizpůsobení.

Platí pro

Sdílet prostřednictvím