CatalogZoneBase.SelectedCatalogPartID Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém ou define uma cadeia de caracteres como um identificador para o controle de CatalogPart selecionado no momento em uma 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

Valor da propriedade

String

Uma cadeia de caracteres que serve como o identificador para o controle selecionado no momento. O padrão é o valor da propriedade do ID controle.

Atributos

ThemeableAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a SelectedCatalogPartID propriedade declarativamente e programaticamente. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo da visão geral da CatalogZoneBase classe.

Observe que a primeira parte do exemplo de código declara dois <asp:catalogzone> elementos e o primeiro 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 de código, o valor de texto da SelectedCatalogPartID propriedade do controle selecionado no momento é exibido.

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

Ao carregar a página em um navegador, você pode selecionar Catálogo na lista suspensa para alternar para o modo de exibição do catálogo. Quando o catálogo estiver visível, clique em um dos links para um CatalogPart controle para selecioná-lo. Em seguida, clique no botão Mostrar ID do Cataloged SelectedPart para exibir o valor da propriedade. Observe que o valor da propriedade é o valor que foi definido declarativamente para a zona. Se você selecionar os outros CatalogPart controles na zona, o mesmo valor se tornará o valor da SelectedCatalogPartID propriedade para cada controle quando ele for selecionado. Se você não definir o valor da SelectedCatalogPartID propriedade, o valor padrão será sempre o valor da ID propriedade para o controle selecionado no momento.

Comentários

A SelectedCatalogPartID propriedade permite que você defina um identificador de sua escolha para o controle selecionado CatalogPart no momento. Isso não altera o valor da propriedade do ID controle, portanto, você pode usar essa propriedade para suas próprias finalidades programáticas. Por exemplo, se você quiser sempre realizar alguma ação programática no controle selecionado CatalogPart no momento, essa propriedade permitirá que você acesse esse controle por meio de um valor conhecido definido com antecedência.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Confira também

• controles de Web Parts ASP.NET