WebPartManager.DisplayMode Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Web Bölümleri denetimlerini içeren bir Web sayfası için etkin görüntüleme modunu alır veya ayarlar.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ DisplayMode { System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ get(); void set(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartDisplayMode DisplayMode { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayMode with get, set
Public Overridable Property DisplayMode As WebPartDisplayMode

Özellik Değeri

WebPartDisplayMode

Sayfanın WebPartDisplayMode görüntüleme modunu belirleyen bir.

Öznitelikler
BrowsableAttribute

Özel durumlar

ArgumentNullException

WebPartDisplayMode özelliğine atanan nesne şeklindedirnull.

ArgumentException

WebPartDisplayMode özelliğine atanan nesne desteklenen görüntü modlarından biri değil.

-veya-

WebPartDisplayMode özelliğine atanan nesne devre dışı bırakıldı.

Örnekler

Aşağıdaki kod örneği, özelliğinin DisplayMode program aracılığıyla kullanımını gösterir. Sayfayı bir tarayıcıda yükledikten sonra, ekran modlarını değiştirmek için sayfanın alt kısmındaki düğmeleri kullanabilirsiniz. Sayfa yüklendiğinde varsayılan olarak göz atma modundadır. Tasarım moduna geçerseniz, sunucu denetimlerini bir bölgeden diğerine sürükleyebilirsiniz veya bir bölge içinde iki denetim düzenleyebilirsiniz. Düzenleme moduna geçerseniz, sunucu denetimlerinden birinin üst bilgisindeki fiiller menüsüne tıklayabilir, Düzenle'yi seçebilir ve sağlanan düzenleme kullanıcı arabirimini (UI) kullanarak denetimi düzenleyebilirsiniz.

Not

Web Bölümleri uygulamasında görüntüleme modları arasında geçiş yapmak çok yaygındır ve Web Bölümleri denetimleri içeren tüm sayfalarınızda bunu yapmak için tutarlı ve yeniden kullanılabilir bir yol sağlamak isteyebilirsiniz. Görüntüleme modlarını değiştiren ve birçok sayfada yeniden kullanılabilen bir kullanıcı denetimi örneği için bkz. İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

<%@ 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 Button1_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.DesignDisplayMode;
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.EditDisplayMode;
  }
  
</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:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" 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:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

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

  
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.DesignDisplayMode
  End Sub
  
  Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.EditDisplayMode
  End Sub
  
</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:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" 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:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

Açıklamalar

Web Bölümleri denetimleri içeren bir sayfa her zaman birkaç olası görüntü modundan birindedir. Görüntüleme modları hakkında ayrıntılı bilgi için bkz. Web Bölümleri Sayfa Görüntüleme Modları.

sınıfı, WebPartManager bir Web sayfası için görüntüleme modlarını oluşturur. Temel WebPartDisplayMode sınıfı kullanarak denetim, WebPartManager Web Bölümleri denetimleri içeren sayfalarda kullanılabilecek birkaç standart görüntüleme modu nesnesi oluşturur. Bu standart görüntüleme modları sınıfa genel bakış bölümünde WebPartDisplayMode açıklanmıştır.

Denetim, WebPartManager Web Bölümleri denetimlerini kullanan sayfaların görüntüleme modlarını da yönetir. DisplayMode özelliği kullanıldığında, WebPartManager denetim sayfadaki geçerli görüntüleme moduna başvuru tutar. Bir sayfayı DisplayMode farklı görüntü modlarına değiştirmek için özelliğini de kullanabilirsiniz. Web Bölümleri denetimlerini kullanan bir sayfadaki görüntüleme modlarını değiştirme örneği için bkz. İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

Denetim, WebPartManager görüntüleme modunu yönetmenin bir parçası olarak, yöntem ve yöntem gibi OnDisplayModeChanged görüntüleme modlarıyla ilgili olaylar ve OnDisplayModeChanging olay işleyicileri de sağlar. Bu yöntemler, bir sayfanın davranışını özelleştirmeye ve hatta özel görüntü modu eklemeye yönelik bir mekanizma sağlar.

Şunlara uygulanır

Ayrıca bkz.