CatalogZoneBase.InstructionText 属性

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

获取或设置区域中为最终用户提供说明的文本。

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

属性值

String

一个字符串，其中包含为最终用户提供的说明。 Web 部件控件集提供的特定于区域性的默认字符串。

示例

下面的代码示例演示如何以声明方式和编程方式使用 InstructionText 属性。 有关运行示例所需的完整代码，请参阅类概述的 CatalogZoneBase “示例”部分。

请注意，代码示例声明两 <asp:catalogzone> 个元素，第一个声明 属性的值 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." />

在代码示例的第二部分中，第一个区域中属性的值 InstructionText 以编程方式分配给不同的值。

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

在浏览器中加载页面时，可以从下拉列表中选择“ 目录 ”以切换到目录显示模式。 当目录可见时，请注意每个区域的标头区域中显示的 属性的值 InstructionText 。 可以单击“ 设置区域文本属性” 按钮，并将 InstructionText 上层区域的 属性设置为代码中分配给它的值。

注解

属性的 InstructionText 字符串值显示在区域的标头区域 CatalogZoneBase 正下方。 当页面进入目录模式并且目录用户界面 (UI) 变为可见时，将显示属性的文本 InstructionText 。

属性的目的是 InstructionText 为用户提供有关显示目录 UI 时要执行的操作的一般说明。

另请参阅

• InstructionText
• ASP.NET Web 部件控件