Bagikan melalui

CatalogZoneBase.SelectTargetZoneText Properti

  • Referensi

Definisi

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

Mendapatkan atau mengatur teks bersama kontrol di antarmuka pengguna katalog (UI) yang memungkinkan pengguna memilih zona mana yang akan ditambahkan kontrol yang dipilih.

public:
 virtual property System::String ^ SelectTargetZoneText { System::String ^ get(); void set(System::String ^ value); };
public virtual string SelectTargetZoneText { get; set; }
member this.SelectTargetZoneText : string with get, set
Public Overridable Property SelectTargetZoneText As String

Nilai Properti

String

String yang berisi teks untuk ditampilkan bersama kontrol pemilihan zona. String khusus budaya default disediakan oleh .NET Framework.

Contoh

Contoh kode berikut menunjukkan cara menggunakan SelectTargetZoneText properti secara deklaratif dan terprogram. Untuk kode lengkap yang diperlukan untuk menjalankan contoh, lihat bagian Contoh dari CatalogZoneBase gambaran umum kelas.

Perhatikan bahwa bagian pertama dari contoh kode mendeklarasikan dua <asp:catalogzone> elemen, dan yang pertama mendeklarasikan nilai untuk SelectTargetZoneText properti .

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

Di bagian kedua dari contoh kode, nilai SelectTargetZoneText properti diubah secara terprogram.

protected void Button3_Click(object sender, EventArgs e)
{
  CatalogZone1.SelectTargetZoneText = "Add to zone";
  CatalogZone1.EmptyZoneText = "Zone is empty";
  CatalogZone1.HeaderText = "My Updated Header";
  CatalogZone1.InstructionText = "My Updated Instructions";
}

Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.SelectTargetZoneText = "Add to zone"
  CatalogZone1.EmptyZoneText = "Zone is empty"
  CatalogZone1.HeaderText = "My Updated Header"
  CatalogZone1.InstructionText = "My Updated Instructions"
End Sub

Saat memuat halaman di browser, Anda dapat memilih Katalog dari daftar drop-down untuk beralih ke mode tampilan katalog. Saat katalog terlihat, perhatikan teks yang ditampilkan bersama DropDownList kontrol di footer katalog. Anda dapat mengklik tombol Atur Properti Teks Zona untuk mengubah nilai teks properti.

Keterangan

Saat UI katalog pertama kali muncul, pengguna dapat memilih salah CatalogPart satu kontrol, seperti DeclarativeCatalogPart, yang berisi WebPart atau kontrol server lain yang dapat ditambahkan ke halaman Web. Pengguna memilih satu atau beberapa kontrol, lalu dapat menggunakan DropDownList kontrol di area footer katalog dan memilih WebPartZone kontrol pada halaman untuk menempatkan kontrol server yang dipilih. Nilai SelectTargetZoneText teks properti ditampilkan bersama DropDownList kontrol sebagai instruksi sederhana.

Nilai properti ini, ketika diatur, dapat disimpan secara otomatis ke file sumber daya dengan menggunakan alat perancang. Untuk informasi selengkapnya, lihat LocalizableAttribute dan Globalisasi dan Pelokalan.

Berlaku untuk

Lihat juga