This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

WebPartManager.DeleteWarning الخاصية

Visual Studio 2010

الحصول على أو تعيينها لعرض رسالة تحذير cusإلىm إلى المستخدمين عندما يقومون بحذف عنصر تحكم.

مساحة الاسم:  System.Web.UI.WebControls.WebParts
التجميع:  System.Web (في System.Web.dll)

public virtual string DeleteWarning { get; set; }
<asp:WebPartManager DeleteWarning="String" />

قيمة الخاصية

النوع: System.String
سلسلة أحرف يحتوي على نص تحذير الرسالة. القيمة افتراضية هو رسالة تحذير مترجم.

عند حذف مستخدم WebPartالتحكم، عادة رسالة تحذير افتراضية هو dهوplayed. فإنه سيقوم بتحذير مستخدم عند th هو مثيل عنصر تحكم هو تم الحذف التم الحذف هو دائمة. قد المطور صفحة بتزويد المستخدمين بطريقة لإضافة مثيل جديد لعنصر التحكم إلى الصفحة (مثل من خلال نشرة WebPartعناصر التحكم، أو من خلال بعض وسائل برمجية)، ولكن مثيل عنصر التحكم الحالي الذي هو حذف هو تمت إزالتها نهائياً. مربع حوار أن تعرض التحذير يتضمن زر للمستخدم إلغاء عملية الحذف، إذا رغبت في ذلك.

DeleteWarning المطورون تمكين خاصية تعيين التحذير الرسائل التي هو dهوplayed للمستخدم.

إذا كان الصفحة يقوم المطور بتعيين سلسلة فارغ ("") القيمة لهذه خاصية، لا يوجد صندوق حوار رسالة التحذير سيظهر عندما يحذف مستخدم WebPartعنصر التحكم.

ملاحظةملاحظة

DeleteWarning خاصية هو غير dهوplayed في حالة من ثابت WebPartوعناصر التحكم عناصر تحكم الملقم. ثابت عناصر التحكم هي عناصر تحكم الملقم الذي يتم التصريح بداخل WebPartZoneBaseمنطقة في ترميز من صفحة ويب. لأن ثابتة مثل عناصر التحكم هذه، لا يمكن يحذف ذلك يحذف رسالة تحذير هو dهوplayed مطلقا في تلك الحالة. ثابت عناصر التحكم can be مغلق بواسطة a مستخدم, but a مغلق عنصر تحكم هو تمت الإضافة إلى the الصفحة كاتالوج, من which it can be تمت الإضافة الخلف إلى the الصفحة بواسطة a مستخدم, whereas a تم الحذف عنصر تحكم can ‏‏مطلقاً be recovered.

The following تعليمات برمجية مثال demonstrates the استخدم of the DeleteWarning خاصية declaratively و programmatically.

There are الرابع parts إلى the تعليمات برمجية مثال:

  • A مستخدم عنصر تحكم that enables you إلى تغيير الصفحة عرض modes.

  • A customWebPartعنصر تحكم.

  • A صفحة ويب.

  • An explanation of how the مثال works في a مستعرض.

The أول part of the تعليمات برمجية مثال هو the مستخدم عنصر تحكم for changing عرض modes. يمكنك الحصول على تعليمات برمجية المصدر عنصر تحكم مستخدم من مقطع مثال WebPartManagerفئة النظرة العامة. للحصول على مزيد من المعلومات حول أوضاع عرض وكيف عنصر تحكم مستخدم، راجع الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويب.

The ثانية part of the تعليمات برمجية مثال هو the مخصص WebPart عنصر تحكم. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . This مثال uses the ديناميكي compilation approach; thus there غير محقق Assembly سمة في the Register directive for this عنصر تحكم at the الأعلى of the ويب الصفحة. للحصول على الإرشادات التفصيلية التي توضح كيفية التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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 (input.Text != String.Empty)
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }

  }
}


الجزء الثالث تعليمات برمجية هو مثال لصفحة ويب. The الصفحة يحتوي على a CatalogZone منطقة, مع the مخصص WebPart عنصر تحكم declared في the منطقة, so that a مستخدم can إضافة it إلى the الصفحة at تشغيل الوقت. ملاحظة that فقط ديناميكي عناصر التحكم (عناصر التحكم that are تمت الإضافة إلى a الصفحة programmatically أو من a كاتالوج مثل this واحد) can be تم الحذف من a الصفحة. ثابت عناصر التحكم (عناصر التحكم that are declared within a WebPartZoneBase منطقة في the ترميز of a الصفحة) can be مغلق, but ‏‏مطلقاً تم الحذف. The <asp:webpartmanager> عنصر declares a مخصص القيمة for the DeleteWarning خاصية بواسطة using the DeleteWarning سمة. The Button1_Click أسلوب assigns another مخصص القيمة إلى the DeleteWarning خاصية.


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


بعد تحميل الصفحة في مستعرض، فإنك تحتاج إلى إضافة WebPartعنصر تحكم للصفحة. عنصر تحكم القائمة منسدلة الوضع عرض باستخدام، تحديد كاتالوج الالوضع. عند ظهور الكتالوج، تحديد خانة اختيار الموجودة بجانب عنصر تحكم مخصص انقر فوق إضافة لإضافته إلى الصفحة وثم انقر فوق يغلق للعودة صفحة استعراض الوضع. والآن بعد أن عنصر التحكم هو vهوible، فيمكنك حذفها. استخدام الوضع Dهوplay التحكم مرة أخرى، بتحويل الصفحة في الوضع التصميم (لا يمكنك يحذف عناصر التحكم أثناء الصفحة هو في الوضع الاستعراض). انقر فوق قائمة الأفعال (الرمز السهم) في العنوان WebPartعنصر تحكم، وتحديد يحذف. التحذير التي قمت بتعيينها تشغيل DeleteWarningتظهر السمة. انقر فوق "إلغاء الأمر". الآن انقر فوق الزر المسمى تحذير يحذف تغيير ، مما يؤدي إلى تغيير القيمة خاصية برمجياً. من قائمة الأفعال على عنصر تحكم تحديد يحذف مرة غير ذلك ولاحظ أن هذه المرة غير ذلك تظهر رسالة تحذير.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: