CatalogZoneBase.SelectedCatalogPartID 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得或設定字串，做為目前在區域中所選取之 CatalogPart 控制項的識別項。

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

屬性值

String

做為目前已選取控制項之識別項的字串。 預設值是控制項之 ID 屬性的值。

屬性
ThemeableAttribute

範例

下列程式碼範例示範如何以宣告方式和程式設計方式使用 SelectedCatalogPartID 屬性。 如需執行範例所需的完整程式碼，請參閱類別概觀的 CatalogZoneBase 範例一節。

請注意，程式碼範例的第一個部分會宣告兩 <asp:catalogzone> 個元素，而第一個部分會宣告 屬性的值 SelectedCatalogPartID 。

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

在程式碼範例的第二個部分中，會顯示目前選取控制項之 屬性的文字值 SelectedCatalogPartID 。

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

當您在瀏覽器中載入頁面時，您可以從下拉式清單中選取 [目錄 ]，以切換至目錄顯示模式。 當目錄可見時，請按一下控制項的其中一個連結 CatalogPart 來選取它。 然後按一下 [ 顯示選取的 CatalogPart 識別碼 ] 按鈕以顯示內容值。 請注意，屬性值是以宣告方式為區域設定的值。 如果您選取區域中的其他 CatalogPart 控制項，則選取時，相同的值會變成每個控制項的 SelectedCatalogPartID 屬性值。 如果您未設定屬性的值 SelectedCatalogPartID ，預設值一律是目前選取控制項的 ID 屬性值。

備註

屬性 SelectedCatalogPartID 可讓您為目前選取 CatalogPart 的控制項設定您選擇的識別碼。 這不會變更控制項的 ID 屬性值，因此您可以將此屬性用於您自己的程式設計用途。 例如，如果您想要一律對目前選取 CatalogPart 的控制項執行一些程式設計動作，此屬性可讓您透過事先設定的已知值來存取該控制項。

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和 ASP.NET 主題和麵板。

適用於

另請參閱