WebZone.EmptyZoneText 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 pesan yang muncul saat zona tidak berisi kontrol.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };

public virtual string EmptyZoneText { get; set; }

member this.EmptyZoneText : string with get, set

Public Overridable Property EmptyZoneText As String

Nilai Properti

String

String yang berisi pesan yang muncul di zona kosong. String khusus budaya default disediakan oleh .NET Framework.

Contoh

Contoh kode berikut menunjukkan penggunaan EmptyZoneText properti . Perhatikan bahwa ada dua zona dalam markup deklaratif, dan elemen kedua <asp:webpartzone> kosong.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!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" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<!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" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

Di browser, Anda dapat beralih ke mode desain untuk melihat teks yang disediakan untuk properti yang EmptyZoneText ditampilkan di zona kosong. Untuk detail tentang cara mengubah mode tampilan halaman, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.

Keterangan

Teks dalam EmptyZoneText properti muncul ketika tidak ada kontrol di zona, dan zona berada dalam salah satu mode personalisasi, seperti mode edit, desain, atau katalog.

Catatan

Ketika zona memasuki salah satu mode personalisasi yang akan memungkinkan perubahan personalisasi dilakukan pada konten zona, WebPartManager kontrol mengatur WebPartDisplayMode.AllowPageDesign nilai properti ke true pada objek mode tampilan yang dirujuk dalam propertinya WebPartManager.DisplayMode .

Berlaku untuk

Lihat juga

ASP.NET Kontrol Komponen Web

Bagikan melalui