CatalogZoneBase.SelectedCatalogPartID 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 string sebagai pengidentifikasi untuk kontrol yang saat ini dipilih CatalogPart di zona.

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

[System.Web.UI.Themeable(false)]
public string SelectedCatalogPartID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.SelectedCatalogPartID : string with get, set

Public Property SelectedCatalogPartID As String

Nilai Properti

String

String yang berfungsi sebagai pengidentifikasi untuk kontrol yang saat ini dipilih. Defaultnya adalah nilai properti kontrol ID .

Atribut: ThemeableAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan SelectedCatalogPartID 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 SelectedCatalogPartID 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 contoh kode, nilai teks untuk SelectedCatalogPartID properti kontrol yang saat ini dipilih ditampilkan.

protected void Button4_Click(object sender, EventArgs e)
{
  Label1.Text = CatalogZone1.SelectedCatalogPartID;
}

Protected Sub Button4_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  Label1.Text = CatalogZone1.SelectedCatalogPartID
End Sub

Saat memuat halaman di browser, Anda dapat memilih Katalog dari daftar drop-down untuk beralih ke mode tampilan katalog. Saat katalog terlihat, klik salah satu tautan ke CatalogPart kontrol untuk memilihnya. Lalu klik tombol Tampilkan ID Bagian Katalog Terpilih untuk menampilkan nilai properti. Perhatikan bahwa nilai properti adalah nilai yang ditetapkan secara deklaratif untuk zona tersebut. Jika Anda memilih kontrol lain CatalogPart di zona tersebut, nilai yang sama akan menjadi nilai SelectedCatalogPartID properti untuk setiap kontrol saat dipilih. Jika Anda tidak mengatur nilai SelectedCatalogPartID properti, nilai default selalu merupakan nilai ID properti untuk kontrol yang saat ini dipilih.

Keterangan

Properti SelectedCatalogPartID memungkinkan Anda mengatur pengidentifikasi pilihan Anda untuk kontrol yang saat ini dipilih CatalogPart . Ini tidak mengubah nilai properti kontrol ID , sehingga Anda dapat menggunakan properti ini untuk tujuan terprogram Anda sendiri. Misalnya, jika Anda ingin selalu melakukan beberapa tindakan terprogram pada kontrol yang saat ini dipilih CatalogPart , properti ini memungkinkan Anda mengakses kontrol tersebut melalui nilai yang diketahui yang Anda tetapkan sebelumnya.

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

ASP.NET Kontrol Komponen Web

Bagikan melalui