CatalogZoneBase.InstructionText Właściwość

Odwołanie

Definicja

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

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia tekst w strefie, która udostępnia 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ładniki Web Part.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać InstructionText właściwości deklaratywnie i programowo. Pełny kod wymagany do uruchomienia przykładu można znaleźć w sekcji Przykład w przeglądzie CatalogZoneBase 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 przechodzi w tryb katalogu, a interfejs użytkownika katalogu staje się widoczny.

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

Dotyczy

Udostępnij przez