CatalogZoneBase.SelectedCatalogPartID Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls.WebParts

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece una cadena como identificador del control CatalogPart seleccionado en ese momento en una 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 de propiedad

String

Una cadena que sirve como identificador del control seleccionado en ese momento. El valor predeterminado es el valor de la propiedad ID del control.

Atributos: ThemeableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la SelectedCatalogPartID propiedad mediante declaración y mediante programación. Para obtener el código completo necesario para ejecutar el ejemplo, consulte la sección Ejemplo de la información general de la CatalogZoneBase clase.

Observe que la primera parte del ejemplo de código declara dos <asp:catalogzone> elementos y la primera declara un valor para la SelectedCatalogPartID propiedad .

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

En la segunda parte del ejemplo de código, se muestra el valor de texto de la SelectedCatalogPartID propiedad del control seleccionado actualmente.

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

Al cargar la página en un explorador, puede seleccionar Catálogo en la lista desplegable para cambiar al modo de presentación del catálogo. Cuando el catálogo esté visible, haga clic en uno de los vínculos a un CatalogPart control para seleccionarlo. A continuación, haga clic en el botón Mostrar catalogpart id. seleccionado para mostrar el valor de la propiedad. Observe que el valor de la propiedad es el valor que se estableció declarativamente para la zona. Si selecciona los demás CatalogPart controles de la zona, el mismo valor se convierte en el valor de la SelectedCatalogPartID propiedad para cada control cuando se selecciona. Si no establece el valor de la SelectedCatalogPartID propiedad, el valor predeterminado es siempre el valor de la ID propiedad para el control seleccionado actualmente.

Comentarios

La SelectedCatalogPartID propiedad permite establecer un identificador de su elección para el control seleccionado CatalogPart actualmente. Esto no cambia el valor de la propiedad del ID control, por lo que puede usar esta propiedad para sus propios fines mediante programación. Por ejemplo, si desea llevar a cabo siempre alguna acción programática en el control seleccionado CatalogPart actualmente, esta propiedad le permite acceder a ese control a través de un valor conocido que establezca de antemano.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también

controles de elementos web de ASP.NET

Compartir vía