CatalogZoneBase.SelectTargetZoneText Eigenschap

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, set

Public Overridable Property SelectTargetZoneText As String

Waarde van eigenschap

Een tekenreeks die de tekst bevat die naast het besturingselement voor zoneselectie moet worden weergegeven. Er wordt een standaard cultuurspecifieke tekenreeks geleverd door het .NET Framework.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de SelectTargetZoneText eigenschap declaratief en programmatisch gebruikt. Zie de sectie Voorbeeld van het CatalogZoneBase klassenoverzicht voor de volledige code die nodig is om het voorbeeld uit te voeren.

U ziet dat het eerste deel van het codevoorbeeld twee <asp:catalogzone> elementen declareert en dat de eerste een waarde voor de SelectTargetZoneText eigenschap declareert.

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

In het tweede deel van het codevoorbeeld wordt de waarde van de SelectTargetZoneText eigenschap programmatisch gewijzigd.

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

Wanneer u de pagina in een browser laadt, kunt u Catalogus selecteren in de vervolgkeuzelijst om over te schakelen naar de weergavemodus van de catalogus. Wanneer de catalogus zichtbaar is, noteert u de tekst die naast het DropDownList besturingselement in de voettekst van de catalogus wordt weergegeven. U kunt op de knop Zoneteksteigenschappen instellen klikken om de tekstwaarde van de eigenschap te wijzigen.

Opmerkingen

Wanneer de catalogusgebruikersinterface voor het eerst wordt weergegeven, kunnen gebruikers een van de CatalogPart besturingselementen selecteren, zoals DeclarativeCatalogPart, die WebPart of andere serverbesturingselementen bevatten die kunnen worden toegevoegd aan de webpagina. De gebruiker selecteert een of meer besturingselementen en kan vervolgens het DropDownList besturingselement in het voettekstgebied van de catalogus gebruiken en het WebPartZone besturingselement kiezen op de pagina waarop de geselecteerde serverbesturingselementen moeten worden geplaatst. De tekstwaarde van de SelectTargetZoneText eigenschap wordt naast het DropDownList besturingselement weergegeven als een eenvoudige instructie.

De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en Globalisatie en Lokalisatie voor meer informatieLocalizableAttribute.

Zie ook

• ASP.NET besturingselementen voor webonderdelen