WebPartManager.DisplayMode Properti
Definisi
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 yang menentukan mode tampilan halaman.
- Atribut
Pengecualian
Objek WebPartDisplayMode yang ditetapkan ke properti adalah null
.
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.