CatalogZoneBase.SelectTargetZoneText Свойство

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Получает или задает текст для элемента управления в пользовательском интерфейсе каталога, с помощью которого пользователи могут выбрать, в какую зону можно добавить выбранные элементы управления.

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

public virtual string SelectTargetZoneText { get; set; }

member this.SelectTargetZoneText : string with get, set

Public Overridable Property SelectTargetZoneText As String

Значение свойства

String

Строка, содержащая текст, который будет отображаться вместе с элементом управления выбора зоны. Строка по умолчанию, зависящая от языка и региональных параметров, предоставляется .NET Framework.

Примеры

В следующем примере кода показано, как использовать SelectTargetZoneText свойство декларативно и программно. Полный код, необходимый для выполнения примера, см. в разделе CatalogZoneBase Пример обзора класса.

Обратите внимание, что в первой части примера кода объявляется два <asp:catalogzone> элемента, а в первой — значение свойства SelectTargetZoneText .

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

Во второй части примера кода значение SelectTargetZoneText свойства изменяется программным способом.

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

При загрузке страницы в браузере можно выбрать Каталог из раскрывающегося списка, чтобы переключиться в режим отображения каталога. Когда каталог виден, обратите внимание на текст, отображаемый рядом с элементом DropDownList управления в нижнем колонтитуле каталога. Вы можете нажать кнопку Задать свойства текста зоны , чтобы изменить текстовое значение свойства .

Комментарии

При первом появлении пользовательского интерфейса каталога пользователи могут выбрать один из CatalogPart элементов управления, например DeclarativeCatalogPart, который содержит WebPart или другие серверные элементы управления, которые можно добавить на веб-страницу. Пользователь выбирает один или несколько элементов управления, а затем может использовать DropDownList элемент управления в нижнем колонтитуле каталога и выбрать WebPartZone элемент управления на странице, на которой будут размещаться выбранные серверные элементы управления. Текстовое SelectTargetZoneText значение свойства отображается рядом с элементом DropDownList управления в виде простой инструкции.

Значение этого свойства можно автоматически сохранить в файле ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделах LocalizableAttributeи Глобализация и локализация.

См. также раздел

• элементы управления веб-частей ASP.NET