Udostępnij za pośrednictwem

CatalogZoneBase.InstructionText Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera lub ustawia tekst w strefie, która zapewnia wskazówki dla użytkowników końcowych.

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

Wartość właściwości

String

Ciąg zawierający wskazówki dla użytkowników końcowych. Domyślny ciąg specyficzny dla kultury jest dostarczany przez zestaw kontrolek składników Web Part.

Przykłady

W poniższym przykładzie kodu pokazano, jak deklaratywnie i programowo używać InstructionText właściwości. Aby zapoznać się z pełnym kodem wymaganym do uruchomienia przykładu, zobacz sekcję Przykładowe CatalogZoneBase omówienie klasy.

Zwróć uwagę, że przykładowy kod deklaruje dwa <asp:catalogzone> elementy, a pierwszy deklaruje wartość właściwości 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." />

W drugiej części przykładu kodu wartość InstructionText właściwości w pierwszej strefie jest programowo przypisywana do innej wartości.

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

Po załadowaniu strony w przeglądarce możesz wybrać pozycję Wykaz z listy rozwijanej, aby przełączyć się do trybu wyświetlania wykazu. Gdy wykaz jest widoczny, zwróć uwagę na wartość InstructionText właściwości wyświetlanej w obszarze nagłówka każdej strefy. Możesz kliknąć przycisk Ustaw właściwości tekstu strefy , a InstructionText właściwość górnej strefy jest ustawiona na wartość przypisaną do niej w kodzie.

Uwagi

Wartość InstructionText ciągu właściwości jest wyświetlana tuż pod obszarem nagłówka CatalogZoneBase strefy. Tekst InstructionText właściwości jest wyświetlany, gdy strona wchodzi w tryb katalogu, a interfejs użytkownika wykazu staje się widoczny.

Celem InstructionText właściwości jest dostarczenie użytkownikowi ogólnych instrukcji dotyczących tego, co należy zrobić po wyświetleniu interfejsu użytkownika wykazu.

Dotyczy

Zobacz też