WebPartManager.DisplayMode Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Web Bölümleri denetimleri 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ıya 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ükleyebilir veya bir bölge içinde iki denetimi 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 bir uygulamada görüntü 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ü 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 denetimler içeren bir sayfa her zaman çeşitli olası görüntü modlarından birindedir. Görüntüleme modları hakkında ayrıntılı bilgi için bkz. sayfa görüntüleme modlarını Web Bölümleri.

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ü modları sınıfa genel bakış bölümünde WebPartDisplayMode açıklanmıştır.

Denetim, WebPartManager Web Bölümleri denetimleri 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 denetimleri kullanan bir sayfadaki görüntü modlarını değiştirme örneği için bkz. İzlenecek Yol: Web Bölümleri Sayfasındaki Görüntü 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

Share via