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.CatalogDisplayMode الحقل

Visual Studio 2010

يمثل الوضع عرض المستخدم لإضافة عناصر تحكم الخادم من كاتالوج عناصر التحكم على صفحة ويب. Th هو الحقل هو القراءة فقط.

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

public static readonly WebPartDisplayMode CatalogDisplayMode

CatalogDisplayMode يشير حقل مخصص WebPartDisplayModeالكائن الذي هو بإنشائه وموجود WebPartManagerعنصر التحكم. لأن ترتيب هو هو كائن ثابت، يمكنك الرجوع إليه مباشرة من خلال WebPartManagerفئة دون الحاجة إلى وجود مثيل من عنصر التحكم.

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

عند تبديل مستخدم صفحة لإنشاء نشرة مصورة لوضع "و" المنطقة "و" الجميع عناصر الملقم التي تمت إضافتها به تصبح مرئي، ويتمكن المستخدم من تحديد عناصر من كاتالوج لإضافته إلى الصفحة، أو قم بإزالة عناصر التحكم من الصفحة. بعد the عناصر التحكم have been تمت الإضافة إلى the الصفحة, they appear في عادي استعراض الوضع و the الصفحة هو محدث.

يلي تعليمات برمجية مثال يوضح كيفية العمل مع CatalogDisplayModeالحقل برمجياً. التعليمة البرمجية لملء قائمة منسدلة مع أوضاع العرض المعتمدة للصفحة، في هذه الحالة وهي الاستعراض والتصميم والنشرة المصورة. يتوفر وضع كتالوج وبسبب <asp:CatalogZone>العنصر وعناصره التابعة في صفحة ويب. لاحظ أنه، في Page_PreRenderالأسلوب، التدقيقات رمز سواء الحالي DisplayModeخاصية هو تعيين إلى CatalogDisplayMode. إذا كان الأمر كذلك، Label1ستكون مرئي، وإذا لم، Label1سيكون مخفي.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Page_Init(object sender, EventArgs e)
  {
    foreach (WebPartDisplayMode mode in mgr.SupportedDisplayModes)
    {
      string modeName = mode.Name;
      if (mode.IsEnabled(mgr))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }      
    }
  }

  protected void DisplayModeDropdown_SelectedIndexChanged(object 
    sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;
    WebPartDisplayMode mode = 
      mgr.SupportedDisplayModes[selectedMode];
    if (mode != null)
      mgr.DisplayMode = mode;
  }

  protected void Page_PreRender(object sender, EventArgs e)
  {
    if (mgr.DisplayMode == WebPartManager.CatalogDisplayMode)
      Label1.Visible = true;
    else
      Label1.Visible = false;
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList> 
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server" />
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart 
            ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" />             
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart>
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:Label ID="Label1" runat="server" 
        Text="Currently in Catalog Mode" 
        Font-Bold="true"
        Font-Size="125%" />
      <br />
      <asp:DropDownList ID="DisplayModeDropdown" 
        runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </div>
    </form>
</body>
</html>


بعد تحميل الصفحة في استعراض r، كنت في استعراض الوضع بشكل افتراضي. Notice that the التسمية تشغيل the الصفحة هو مخفي. استخدم the إسقاط-أسفل عنصر تحكم القائمة إلى تبديل the الصفحة إلى كاتالوج الوضع. Notice that, because of the تعليمات برمجية في the Page_PreRender أسلوب, the التسمية هو now مرئي. You can تحديد the عنصر تحكم في the كاتالوج و إضافة it إلى either of the الثاني zones تشغيل the الصفحة.

نظام التشغيل 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
إظهار: