CatalogZoneBase.SelectTargetZoneText Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o texto junto com o controle na interface do usuário (UI) de catálogo que permite aos usuários escolher para qual zona adicionar seus controles selecionados.
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 da propriedade
Uma cadeia de caracteres que contém o texto a ser exibido junto com o controle de seleção de zona. Uma cadeia de caracteres específica da cultura padrão é fornecida pelo .NET Framework.
Exemplos
O exemplo de código a seguir demonstra como usar a SelectTargetZoneText 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 SelectTargetZoneText 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 da SelectTargetZoneText propriedade é alterado programaticamente.
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
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, observe o texto exibido junto com o DropDownList controle no rodapé do catálogo. Você pode clicar no botão Definir Propriedades de Texto de Zona para alterar o valor de texto da propriedade.
Comentários
Quando a interface do usuário do catálogo é exibida pela primeira vez, os usuários podem selecionar um dos CatalogPart controles, como DeclarativeCatalogPart, que contém WebPart ou outros controles de servidor que podem ser adicionados à página da Web. O usuário seleciona um ou mais controles e, em seguida, pode usar o DropDownList controle na área de rodapé do catálogo e escolher o WebPartZone controle na página na qual colocar os controles de servidor selecionados. O valor de texto da SelectTargetZoneText propriedade é exibido junto com o DropDownList controle como uma instrução simples.
O valor dessa propriedade, quando definido, pode ser salvo automaticamente em um arquivo de recurso usando uma ferramenta de designer. Para obter mais informações, consulte LocalizableAttributeGlobalização e Localização.
