Bagikan melalui

WebPart.Hidden Properti

  • Referensi

Definisi

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

Mendapatkan atau mengatur nilai yang menunjukkan apakah WebPart kontrol ditampilkan di halaman Web.

public:
 virtual property bool Hidden { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable]
public virtual bool Hidden { get; set; }
[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable>]
member this.Hidden : bool with get, set
Public Overridable Property Hidden As Boolean

Nilai Properti

Boolean

falseWebPart jika kontrol ditampilkan di halaman Web; jika tidak, true. Nilai defaultnya adalah false.

Atribut
ThemeableAttribute PersonalizableAttribute

Contoh

Contoh kode berikut menunjukkan penggunaan Hidden properti untuk kontrol Komponen Web kustom. Contoh ini mengasumsikan penggunaan kontrol kustom, TextDisplayWebPart, yang ditemukan di bagian Contoh dari WebPart gambaran umum kelas.

Perhatikan bahwa di halaman Web, dalam markup deklaratif untuk <aspSample:TextDisplayWebPart> elemen , Hidden nilai atribut diatur ke true. Kontrol TextDisplayWebPart tidak akan muncul jika halaman dimuat di browser. Namun, kontrol masih ada di halaman dan di zonanya, dan masih dapat berpartisipasi dalam koneksi dengan kontrol lain WebPart jika Anda membuat koneksi tersebut.

<%@ 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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Hidden="true" />
          </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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Hidden="true" />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Keterangan

WebPart Kontrol yang tersembunyi tetap berada di zonanya, sebenarnya dirender di halamannya, dan berpartisipasi dalam fase siklus hidup halaman seperti PreRender fase, meskipun tidak terlihat di browser. Ini berbeda dari WebPart kontrol yang ditutup, karena kontrol tertutup bahkan tidak dirender pada halaman, sementara kontrol tersembunyi dirender dan aktif dalam aplikasi Komponen Web, meskipun tidak terlihat oleh pengguna. Kumpulan kontrol Bagian Web menyembunyikan WebPart kontrol dengan mengatur gaya lembar gaya bertingkat (CSS) ke nilai display:none.

Bahkan jika Hidden properti untuk kontrol diatur ke true, kontrol masih ditampilkan jika mode tampilan saat ini pada halaman memungkinkan kontrol tersembunyi ditampilkan. Misalnya, mode edit memungkinkan kontrol tersembunyi ditampilkan, sehingga pengguna dapat mengeditnya. Ketika kontrol tersembunyi terlihat dalam mode tampilan tertentu, judul kontrol menampilkan string yang menunjukkan bahwa kontrol berada dalam status tersembunyi.

Hidden Ketika properti pada WebPart kontrol diatur ke false, yang merupakan default, kontrol ditampilkan di halaman. Perhatikan bahwa jika AllowHide properti diatur ke false, pengguna akhir tidak diizinkan untuk mengedit Hidden nilai properti.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Berlaku untuk

Lihat juga