CatalogZoneBase.SelectedCatalogPartID Propriedade

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

Valor de Propriedade

Uma cadeia que serve como identificador para o controlo atualmente selecionado. O valor padrão é o valor da propriedade do ID controlo.

Atributos

ThemeableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar a SelectedCatalogPartID propriedade de forma declarativa e programática. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo da CatalogZoneBase visão geral da classe.

Note que a primeira parte do exemplo de código declara dois <asp:catalogzone> elementos, e a primeira declara um valor para a SelectedCatalogPartID propriedade.

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

Na segunda parte do exemplo do código, é apresentado o valor de texto da SelectedCatalogPartID propriedade do controlo atualmente selecionado.

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

Quando carregas a página num navegador, podes selecionar Catálogo na lista suspensa para mudar para o modo de visualização do catálogo. Quando o catálogo estiver visível, clique num dos links para um CatalogPart controlo para o selecionar. Depois, clique no botão Mostrar ID de Parte do Catálogo Selecionado para mostrar o valor da propriedade. Note que o valor da propriedade é o valor que foi definido declarativamente para a zona. Se selecionares os outros CatalogPart controlos na zona, o mesmo valor torna-se o valor da SelectedCatalogPartID propriedade para cada controlo quando este é selecionado. Se não definir o valor da SelectedCatalogPartID propriedade, o valor padrão é sempre o valor da ID propriedade para o controlo atualmente selecionado.

Observações

A SelectedCatalogPartID propriedade permite-lhe definir um identificador à sua escolha para o controlo atualmente selecionado CatalogPart . Isto não altera o valor da propriedade do ID controlo, por isso pode usar esta propriedade para os seus próprios fins programáticos. Por exemplo, se quiser sempre realizar alguma ação programática sobre o controlo atualmente selecionado CatalogPart , esta propriedade permite-lhe aceder a esse controlo através de um valor conhecido que definiu antecipadamente.

Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Ver também

• ASP.NET Controlos de Web Parts