CatalogZoneBase.SelectTargetZoneText Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá nebo nastaví text vedle ovládacího prvku v uživatelském rozhraní katalogu , který umožňuje uživatelům zvolit, do které zóny mají přidat své vybrané ovládací prvky.

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

Hodnota vlastnosti

String

Řetězec obsahující text, který se má zobrazit vedle ovládacího prvku pro výběr zóny. Rozhraní .NET Framework poskytuje výchozí řetězec specifický pro jazykovou verzi.

Příklady

Následující příklad kódu ukazuje, jak používat SelectTargetZoneText vlastnost deklarativní a programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad přehledu CatalogZoneBase třídy.

Všimněte si, že první část příkladu kódu deklaruje dva <asp:catalogzone> prvky a první část deklaruje hodnotu vlastnosti 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." />

V druhé části příkladu kódu se hodnota SelectTargetZoneText vlastnosti změní programově.

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

Když stránku načtete v prohlížeči, můžete z rozevíracího seznamu vybrat katalog a přepnout do režimu zobrazení katalogu. Když je katalog viditelný, všimněte si textu zobrazeného DropDownList vedle ovládacího prvku v zápatí katalogu. Můžete kliknout na tlačítko Nastavit vlastnosti textu zóny a změnit textovou hodnotu vlastnosti.

Poznámky

Po prvním zobrazení uživatelského rozhraní katalogu mohou uživatelé vybrat jeden z CatalogPart ovládacích prvků, například DeclarativeCatalogPart, který obsahuje WebPart nebo jiné serverové ovládací prvky, které lze přidat na webovou stránku. Uživatel vybere jeden nebo více ovládacích prvků a pak může ovládací prvek použít DropDownList v oblasti zápatí katalogu a zvolit WebPartZone ovládací prvek na stránce, do které chcete umístit vybrané ovládací prvky serveru. Textová hodnota SelectTargetZoneText vlastnosti je zobrazena vedle DropDownList ovládacího prvku jako jednoduchá instrukce.

Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace naleznete v tématu LocalizableAttribute a globalizace a lokalizace.

Viz také

• ovládací prvky webových částí ASP.NET