CatalogZoneBase.SelectTargetZoneText Propiedad
Definición
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 el texto que aparece junto al control de la interfaz de usuario del catálogo (IU) y que permite a los usuarios elegir a qué zona desean agregar los controles que tienen seleccionados.
public:
virtual property System::String ^ SelectTargetZoneText { System::String ^ get(); void set(System::String ^ value); };public virtual string SelectTargetZoneText { get; set; }member this.SelectTargetZoneText : string with get, setPublic Overridable Property SelectTargetZoneText As StringValor de propiedad
Una cadena que contiene el texto que se desea mostrar junto al control de la zona seleccionada. .NET Framework proporciona una cadena de referencia cultural predeterminada.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la SelectTargetZoneText propiedad mediante declaración y mediante programación. Para obtener el código completo necesario para ejecutar el ejemplo, vea 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 SelectTargetZoneText 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, el valor de la SelectTargetZoneText propiedad se cambia mediante programación.
protected void Button3_Click(object sender, EventArgs e)
{
CatalogZone1.SelectTargetZoneText = "Add to zone";
CatalogZone1.EmptyZoneText = "Zone is empty";
CatalogZone1.HeaderText = "My Updated Header";
CatalogZone1.InstructionText = "My Updated Instructions";
}
Protected Sub Button3_Click(ByVal sender As Object, _
ByVal e As EventArgs)
CatalogZone1.SelectTargetZoneText = "Add to zone"
CatalogZone1.EmptyZoneText = "Zone is empty"
CatalogZone1.HeaderText = "My Updated Header"
CatalogZone1.InstructionText = "My Updated Instructions"
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, anote el texto que se muestra junto con el DropDownList control en el pie de página del catálogo. Puede hacer clic en el botón Establecer propiedades de texto de zona para cambiar el valor de texto de la propiedad.
Comentarios
Cuando aparezca la interfaz de usuario del catálogo por primera vez, los usuarios pueden seleccionar uno de los CatalogPart controles, como DeclarativeCatalogPart, que contiene WebPart u otros controles de servidor que se pueden agregar a la página web. El usuario selecciona uno o varios controles y, a continuación, puede usar el DropDownList control en el área de pie de página del catálogo y elegir el WebPartZone control de la página en la que colocar los controles de servidor seleccionados. El valor de texto de la SelectTargetZoneText propiedad se muestra junto con el DropDownList control como una instrucción simple.
El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttributeGlobalización y localización.
