WebPartManager.DeleteWarning Eigenschap

public:
 virtual property System::String ^ DeleteWarning { System::String ^ get(); void set(System::String ^ value); };

public virtual string DeleteWarning { get; set; }

member this.DeleteWarning : string with get, set

Public Overridable Property DeleteWarning As String

Waarde van eigenschap

Een tekenreeks die de tekst van het waarschuwingsbericht bevat. De standaardwaarde is een gelokaliseerd waarschuwingsbericht.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de DeleteWarning eigenschap declaratief en programmatisch.

Er zijn vier onderdelen voor het codevoorbeeld:

• Een gebruikersbeheer waarmee u de weergavemodi voor pagina's kunt wijzigen.

• Een aangepast besturingselement WebPart .

• Een webpagina.

• Een uitleg van hoe het voorbeeld werkt in een browser.

Het eerste deel van het codevoorbeeld is het gebruikersbeheer voor het wijzigen van weergavemodi. U kunt de broncode voor het gebruikersbeheer verkrijgen in de sectie Voorbeeld van het WebPartManager klassenoverzicht. Zie Walkthrough: Weergavemodi wijzigen op een pagina met webonderdelen voor meer informatie over weergavemodi en hoe het gebruikersbeheer werkt.

Het tweede deel van het codevoorbeeld is het aangepaste WebPart besturingselement. Als u het codevoorbeeld wilt uitvoeren, moet u deze broncode compileren. U kunt deze expliciet compileren en de resulterende assembly in de map Bin van uw website of de globale assemblycache plaatsen. U kunt de broncode ook in de map App_Code van uw site plaatsen, waar deze dynamisch wordt gecompileerd tijdens runtime. In dit voorbeeld wordt de dynamische compilatiebenadering gebruikt; Er is dus geen Assembly kenmerk in de Register richtlijn voor dit besturingselement boven aan de webpagina. Zie Walkthrough: Een aangepast webserverbeheer ontwikkelen en gebruiken voor een overzicht van hoe u compileert.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
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;
    Literal lineBreak;

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

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

    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.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
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 _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      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)

    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

Het derde deel van het codevoorbeeld is de webpagina. De pagina bevat een CatalogZone zone, met het aangepaste WebPart besturingselement dat in de zone is gedeclareerd, zodat een gebruiker deze tijdens runtime aan de pagina kan toevoegen. Houd er rekening mee dat alleen dynamische besturingselementen (besturingselementen die via een programma of vanuit een catalogus zoals deze worden toegevoegd) van een pagina kunnen worden verwijderd. Statische besturingselementen (besturingselementen die binnen een WebPartZoneBase zone in de opmaak van een pagina worden gedeclareerd) kunnen worden gesloten, maar nooit worden verwijderd. Het <asp:webpartmanager> element declareert een aangepaste waarde voor de DeleteWarning eigenschap met behulp van het DeleteWarning kenmerk. Met Button1_Click de methode wordt een andere aangepaste waarde aan de DeleteWarning eigenschap toegewezen.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuCS"
    Src="~/DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  const String NewWarning = @"If you delete this WebPart " + 
    "control instance, it will be permanently removed and " +
    "cannot be retrieved.  Do you still want to delete it?";
    
  protected void Button1_Click(object sender, EventArgs e)
  {
    mgr1.DeleteWarning = NewWarning;
  }

  // Hide the button to change the property when there is
  // no control available to delete.
  protected void Page_Load(object sender, EventArgs e)
  {
    if (WebPartZone1.WebParts.Count == 0)
      Button1.Visible = false;
    else
      Button1.Visible = true;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="mgr1" runat="server" 
        DeleteWarning="Do you want to delete this control?" />
      <uc1:DisplayModeMenuCS ID="menu1" runat="server" />
      <h2>Delete Warning Example Page</h2>
      <asp:WebPartZone ID="WebPartZone1" runat="server" />
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart 
            ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart ID="text1" 
                runat="server" 
                Title="My Text WebPart" />
             </WebPartsTemplate>
          </asp:DeclarativeCatalogPart>  
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Change Delete Warning" 
        OnClick="Button1_Click" />
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuVB"
    Src="~/DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Private Const NewWarning As String = "If you delete this WebPart " & _
    "control instance, it will be permanently removed and " & _
    "cannot be retrieved.  Do you still want to delete it?"

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    mgr1.DeleteWarning = NewWarning

  End Sub
  
  Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As EventArgs)

    If WebPartZone1.WebParts.Count = 0 Then
      Button1.Visible = False
    Else
      Button1.Visible = True
    End If
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="mgr1" runat="server" 
        DeleteWarning="Do you want to delete this control?" />
      <uc1:DisplayModeMenuVB ID="menu1" runat="server" />
      <h2>Delete Warning Example Page</h2>
      <asp:WebPartZone ID="WebPartZone1" runat="server" />
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart 
            ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart ID="text1" 
                runat="server" 
                Title="My Text WebPart" />
             </WebPartsTemplate>
          </asp:DeclarativeCatalogPart>  
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Change Delete Warning" 
         OnClick="Button1_Click" />
    </form>
</body>
</html>

Nadat u de pagina in een browser hebt geladen, moet u het WebPart besturingselement toevoegen aan de pagina. Selecteer de catalogusmodus met behulp van het vervolgkeuzelijstbesturingselement Weergavemodus . Wanneer de catalogus wordt weergegeven, schakelt u het selectievakje naast het aangepaste besturingselement in, klikt u op Toevoegen om deze toe te voegen aan de pagina en klikt u vervolgens op Sluiten om de pagina te retourneren om de bladermodus te activeren. Nu het besturingselement zichtbaar is, kunt u het verwijderen. Als u het besturingselement Weergavemodus opnieuw gebruikt, schakelt u de pagina over naar de ontwerpmodus (u kunt besturingselementen niet verwijderen terwijl de pagina zich in de bladermodus bevindt). Klik op het menu Werkwoorden (het pijlsymbool) in de koptekst van het WebPart besturingselement en selecteer Verwijderen. De waarschuwing die u voor het DeleteWarning kenmerk hebt ingesteld, wordt weergegeven. Klik op Annuleren. Klik nu op de knop Met het label Waarschuwing Verwijderen wijzigen, waardoor de eigenschapswaarde programmatisch wordt gewijzigd. Selecteer opnieuw verwijderen in het menu Werkwoorden in het besturingselement en u ziet dat dit keer het andere waarschuwingsbericht wordt weergegeven.

Opmerkingen

Wanneer een gebruiker een WebPart besturingselement verwijdert, wordt normaal gesproken een standaardwaarschuwingsbericht weergegeven. De gebruiker wordt gewaarschuwd dat wanneer dit exemplaar van een besturingselement wordt verwijderd, de verwijdering permanent is. De ontwikkelaar van de pagina kan gebruikers een manier bieden om een nieuw exemplaar van het besturingselement toe te voegen aan de pagina (zoals via een catalogus WebPart met besturingselementen of via programmatische middelen), maar het huidige exemplaar van een verwijderd besturingselement wordt definitief verwijderd. Het dialoogvenster waarin de waarschuwing wordt weergegeven, bevat desgewenst een knop voor de gebruiker om de verwijdering te annuleren.

Met DeleteWarning de eigenschap kunnen ontwikkelaars het waarschuwingsbericht instellen dat wordt weergegeven aan de gebruiker.

Als een paginaontwikkelaar een lege tekenreeks ("") aan deze eigenschap toewijst, wordt er geen waarschuwingsberichtvenster weergegeven wanneer een gebruiker een WebPart besturingselement verwijdert.

Zie ook

• DeleteWebPart(WebPart)
• ASP.NET besturingselementen voor webonderdelen