CatalogZoneBase.SelectedCatalogPartID Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:

System.Web.dll

Bir bölgede seçili CatalogPart durumdaki denetim için bir dizeyi tanımlayıcı olarak alır veya ayarlar.

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

Özellik Değeri

String

Seçili durumdaki denetimin tanımlayıcısı olarak hizmet veren bir dize. Varsayılan değer, denetimin ID özelliğinin değeridir.

Öznitelikler

ThemeableAttribute

Örnekler

Aşağıdaki kod örneği, özelliğini bildirimli SelectedCatalogPartID ve programlı olarak kullanmayı gösterir. Örneği çalıştırmak için gereken kodun tamamı için, sınıfa genel bakışın CatalogZoneBase Örnek bölümüne bakın.

Kod örneğinin ilk bölümünün iki <asp:catalogzone> öğe bildirdiğini ve ilkinin özelliği için bir değer bildirdiğini SelectedCatalogPartID fark edin.

<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." />

Kod örneğinin ikinci bölümünde, seçili durumdaki denetimin SelectedCatalogPartID özelliği için metin değeri görüntülenir.

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

Sayfayı bir tarayıcıya yüklediğinizde, katalog görüntüleme moduna geçmek için açılan listeden Katalog'a tıklayabilirsiniz. Katalog görünür olduğunda, denetimi seçmek için bir CatalogPart denetimin bağlantılarından birine tıklayın. Ardından, özellik değerini görüntülemek için Seçili Kataloğu GösterPart Kimliği düğmesine tıklayın. özelliğinin değerinin bölge için bildirim temelli olarak ayarlanan değer olduğuna dikkat edin. Bölgedeki diğer CatalogPart denetimleri seçerseniz, aynı değer seçildiğinde her denetim için özelliğin SelectedCatalogPartID değeri olur. Özelliğin SelectedCatalogPartID değerini ayarlamazsanız, varsayılan değer her zaman seçili durumdaki ID denetim için özelliğin değeridir.

Açıklamalar

özelliği, SelectedCatalogPartID seçili CatalogPart durumdaki denetim için tercih ettiğiniz bir tanımlayıcıyı ayarlamanıza olanak tanır. Bu, denetimin ID özellik değerini değiştirmez, bu nedenle bu özelliği kendi programlı amaçlarınız için kullanabilirsiniz. Örneğin, seçili CatalogPart durumdaki denetimde her zaman programlı bir eylem gerçekleştirmek istiyorsanız, bu özellik önceden ayarladığınız bilinen bir değer aracılığıyla bu denetime erişmenizi sağlar.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . Temalar ve Dış Görünümler'i ASP.NET.

Ayrıca bkz.

• Web Bölümleri Denetimlerini ASP.NET