WebPartManager.DisplayMode Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau menyetel mode tampilan aktif untuk halaman Web yang berisi kontrol Bagian Web.

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

Nilai Properti

WebPartDisplayMode

WebPartDisplayMode yang menentukan mode tampilan halaman.

Atribut: BrowsableAttribute

Pengecualian

ArgumentNullException

Objek WebPartDisplayMode yang ditetapkan ke properti adalah null.

ArgumentException

Objek WebPartDisplayMode yang ditetapkan ke properti bukan salah satu mode tampilan yang didukung.

-atau-

Objek WebPartDisplayMode yang ditetapkan ke properti dinonaktifkan.

Contoh

Contoh kode berikut menunjukkan penggunaan properti terprogram DisplayMode . Setelah memuat halaman di browser, Anda dapat menggunakan tombol di dekat bagian bawah halaman untuk beralih mode tampilan. Halaman berada dalam mode telusuri secara default saat dimuat. Jika Anda beralih ke mode desain, Anda dapat menyeret kontrol server dari satu zona ke zona lainnya, atau mengatur dua kontrol dalam satu zona. Jika Anda beralih ke mode edit, Anda dapat mengklik menu kata kerja di header salah satu kontrol server, pilih Edit, dan edit kontrol menggunakan antarmuka pengguna pengeditan (UI) yang disediakan.

Catatan

Beralih di antara mode tampilan dalam aplikasi Bagian Web sangat umum, dan Anda mungkin ingin menyediakan cara yang konsisten dan dapat digunakan kembali untuk melakukan ini pada semua halaman Anda yang berisi kontrol Bagian Web. Untuk contoh kontrol pengguna yang mengubah mode tampilan dan yang dapat digunakan kembali di banyak halaman, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.

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

Keterangan

Halaman yang berisi kontrol Bagian Web selalu dalam salah satu dari beberapa mode tampilan yang mungkin. Untuk detail tentang mode tampilan, lihat Mode Tampilan Halaman Bagian Web.

Kelas WebPartManager membuat mode tampilan untuk halaman Web. Dengan menggunakan kelas dasar WebPartDisplayMode , WebPartManager kontrol membuat beberapa objek mode tampilan standar yang dapat digunakan pada halaman yang berisi kontrol Bagian Web. Mode tampilan standar ini dijelaskan dalam gambaran WebPartDisplayMode umum kelas.

WebPartManager Kontrol juga mengelola mode tampilan untuk halaman yang menggunakan kontrol Bagian Web. DisplayMode Dengan menggunakan properti , WebPartManager kontrol menyimpan referensi ke mode tampilan saat ini pada halaman. Anda juga dapat menggunakan DisplayMode properti untuk mengalihkan halaman ke mode tampilan yang berbeda. Untuk contoh mengubah mode tampilan pada halaman yang menggunakan kontrol Bagian Web, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.

Sebagai bagian dari pengelolaan mode tampilan, WebPartManager kontrol juga menyediakan peristiwa dan penanganan aktivitas yang berkaitan dengan mode tampilan, seperti OnDisplayModeChanged metode dan OnDisplayModeChanging metode . Metode ini menyediakan mekanisme untuk menyesuaikan perilaku halaman, dan bahkan untuk menambahkan mode tampilan kustom.

Berlaku untuk

Bagikan melalui