CatalogZoneBase.InstructionText Eigenschap

public:
 virtual property System::String ^ InstructionText { System::String ^ get(); void set(System::String ^ value); };

public override string InstructionText { get; set; }

member this.InstructionText : string with get, set

Public Overrides Property InstructionText As String

Waarde van eigenschap

Een tekenreeks die de aanwijzingen voor eindgebruikers bevat. Een standaard, cultuurspecifieke tekenreeks wordt geleverd door de besturingsset webonderdelen.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de InstructionText 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 in het codevoorbeeld twee <asp:catalogzone> elementen worden declareren en dat de eerste een waarde voor de InstructionText 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 InstructionText eigenschap in de eerste zone programmatisch toegewezen aan een andere waarde.

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, ziet u de waarde van de InstructionText eigenschap die wordt weergegeven in het koptekstgebied van elke zone. U kunt op de knop Eigenschappen van zonetekst instellen klikken en de InstructionText eigenschap van de bovenste zone is ingesteld op de waarde die eraan is toegewezen in de code.

Opmerkingen

De tekenreekswaarde van de InstructionText eigenschap wordt net onder het koptekstgebied van een CatalogZoneBase zone weergegeven. De tekst van de InstructionText eigenschap wordt weergegeven wanneer een pagina de catalogusmodus opent en de gebruikersinterface van de catalogus zichtbaar wordt.

Het doel van de InstructionText eigenschap is om de gebruiker algemene instructies te geven over wat u moet doen wanneer de catalogusgebruikersinterface wordt weergegeven.

Zie ook

• InstructionText
• ASP.NET besturingselementen voor webonderdelen