WebPart.HelpMode 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 mengatur jenis antarmuka pengguna (UI) yang digunakan untuk menampilkan konten Bantuan untuk WebPart kontrol.
public:
virtual property System::Web::UI::WebControls::WebParts::WebPartHelpMode HelpMode { System::Web::UI::WebControls::WebParts::WebPartHelpMode get(); void set(System::Web::UI::WebControls::WebParts::WebPartHelpMode value); };
[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)]
public virtual System.Web.UI.WebControls.WebParts.WebPartHelpMode HelpMode { get; set; }
[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)>]
member this.HelpMode : System.Web.UI.WebControls.WebParts.WebPartHelpMode with get, set
Public Overridable Property HelpMode As WebPartHelpMode
Nilai Properti
Salah WebPartHelpMode satu nilai. Default adalah Modal.
- Atribut
Pengecualian
Nilai yang ditentukan bukan salah WebPartHelpMode satu nilai.
Contoh
Contoh kode berikut menunjukkan penggunaan HelpMode properti untuk menampilkan Bantuan untuk kontrol di jendela browser yang sama. Bagian pertama dari contoh ini mengasumsikan penggunaan kontrol kustom, TextDisplayWebPart
, yang ditemukan di bagian Contoh dari WebPart gambaran umum kelas.
Contoh kode juga menyertakan halaman HTML yang berisi konten Bantuan fiktif untuk TextDisplayWebPart
kontrol. Agar contoh ini berfungsi, Anda harus menyimpan kode berikut dalam file bernama Textwebparthelp.htm dan menempatkannya di direktori situs yang sama dengan halaman .aspx.
<html>
<head runat="server">
<title>Text Content WebPart Help</title>
</head>
<body>
<div>
<h1>Text Content WebPart Help</h1>
To make the WebPart control work...
</div>
</body>
</html>
Bagian akhir dari contoh adalah halaman Web yang memperlihatkan cara mereferensikan TextDisplayWebPart
kontrol. Perhatikan bahwa dalam markup deklaratif, HelpMode nilai properti diatur ke Navigate, dan kode juga mengatur nilai HelpUrl properti ke nama file HTML yang berisi konten Bantuan. Muat halaman ke browser, dan klik kata kerja bantuan pada menu WebPart kata kerja kontrol.
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
HelpMode="navigate"
HelpUrl="TextWebPartHelp.htm" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
width="350px"
HelpMode="navigate"
HelpUrl="TextWebPartHelp.htm" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Keterangan
HelpMode Gunakan properti untuk menentukan bagaimana browser akan menampilkan konten Bantuan untuk kontrol. Tabel berikut ini mencantumkan efek berbagai mode Bantuan pada browser saat konten Bantuan untuk WebPart kontrol ditampilkan.
Mode bantuan | Perilaku browser |
---|---|
Modal | Membuka jendela browser terpisah, jika browser memiliki kemampuan ini. Pengguna harus menutup jendela sebelum kembali ke halaman Bagian Web. |
Modeless | Membuka jendela browser terpisah, jika browser memiliki kemampuan ini. Pengguna tidak perlu menutup jendela sebelum kembali ke halaman Web. |
Navigate | Mengganti halaman Bagian Web di jendela browser. |
Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.
Cakupan personalisasi properti ini diatur ke Shared dan hanya dapat dimodifikasi oleh pengguna yang berwenang. Untuk informasi selengkapnya, lihat PersonalizableAttribute dan Gambaran Umum Personalisasi Bagian Web.