WebPart.HelpMode 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 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

WebPartHelpMode

Salah WebPartHelpMode satu nilai. Default adalah Modal.

Atribut: ThemeableAttribute PersonalizableAttribute

Pengecualian

ArgumentOutOfRangeException

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.

Berlaku untuk

Bagikan melalui