CatalogZoneBase.SelectTargetZoneText Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Pobiera lub ustawia tekst obok kontrolki w interfejsie użytkownika katalogu, który umożliwia użytkownikom wybranie strefy, do której mają zostać dodane wybrane kontrolki.

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

Wartość właściwości

String

Ciąg zawierający tekst do wyświetlenia obok kontrolki zaznaczenia strefy. Domyślny ciąg specyficzny dla kultury jest dostarczany przez program .NET Framework.

Przykłady

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

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

W drugiej części przykładu kodu wartość SelectTargetZoneText właściwości jest zmieniana programowo.

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, zanotuj tekst wyświetlany obok DropDownList kontrolki w stopce wykazu. Możesz kliknąć przycisk Ustaw właściwości tekstu strefy , aby zmienić wartość tekstową właściwości.

Uwagi

Po pierwszym wyświetleniu interfejsu użytkownika wykazu użytkownicy mogą wybrać jedną z CatalogPart kontrolek, taką jak DeclarativeCatalogPart, która zawiera WebPart lub inne kontrolki serwera, które można dodać do strony sieci Web. Użytkownik wybiera co najmniej jedną kontrolkę, a następnie może użyć DropDownList kontrolki w obszarze stopki katalogu i wybrać kontrolkę WebPartZone na stronie, na której mają być stosowane wybrane kontrolki serwera. Wartość tekstowa SelectTargetZoneText właściwości jest wyświetlana obok kontrolki DropDownList jako prosta instrukcja.

Wartość tej właściwości, po ustawieniu, można automatycznie zapisać w pliku zasobów za pomocą narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttributeGlobalization and Localization (Globalizacja i lokalizacja).

Zobacz też

• kontrolki składników Web Part ASP.NET