Sdílet prostřednictvím

CatalogZoneBase.InstructionText Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá nebo nastaví text v zóně, která poskytuje pokyny pro koncové uživatele.

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

Hodnota vlastnosti

String

Řetězec, který obsahuje pokyny pro koncové uživatele. Sada ovládacích prvků webových částí poskytuje výchozí řetězec specifický pro jazykovou verzi.

Příklady

Následující příklad kódu ukazuje, jak použít InstructionText vlastnost deklarativně a programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v přehledu CatalogZoneBase třídy.

Všimněte si, že příklad kódu deklaruje dva <asp:catalogzone> prvky a první deklaruje hodnotu vlastnosti InstructionText .

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

V druhé části příkladu kódu je hodnota InstructionText vlastnosti v první zóně programově přiřazena k jiné hodnotě.

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

Když stránku načtete v prohlížeči, můžete výběrem možnosti Katalog z rozevíracího seznamu přepnout do režimu zobrazení katalogu. Když je katalog viditelný, všimněte si hodnoty InstructionText vlastnosti zobrazené v oblasti záhlaví každé zóny. Můžete kliknout na tlačítko Nastavit vlastnosti textu zóny a InstructionText vlastnost horní zóny se nastaví na hodnotu přiřazenou v kódu.

Poznámky

Řetězcová hodnota InstructionText vlastnosti je zobrazena těsně pod oblastí CatalogZoneBase záhlaví zóny. Text vlastnosti se zobrazí, InstructionText když stránka přejde do režimu katalogu a uživatelské rozhraní katalogu se zobrazí.

Účelem InstructionText vlastnosti je poskytnout uživateli obecné pokyny, co dělat, když se zobrazí uživatelské rozhraní katalogu.

Platí pro

Viz také