CatalogZoneBase.SelectTargetZoneText Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar eller anger texten tillsammans med kontrollen i katalogens användargränssnitt (UI) som gör att användarna kan välja vilken zon de vill lägga till sina valda kontroller i.

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

Egenskapsvärde

String

En sträng som innehåller texten som ska visas tillsammans med markeringskontrollen för zonen. En standardkulturspecifik sträng tillhandahålls av .NET Framework.

Exempel

Följande kodexempel visar hur du använder SelectTargetZoneText egenskapen deklarativt och programmatiskt. Den fullständiga kod som krävs för att köra exemplet finns i avsnittet Exempel i klassöversikten CatalogZoneBase .

Observera att den första delen av kodexemplet deklarerar två <asp:catalogzone> element och den första deklarerar ett värde för SelectTargetZoneText egenskapen.

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

I den andra delen av kodexemplet ändras värdet för SelectTargetZoneText egenskapen programmatiskt.

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

När du läser in sidan i en webbläsare kan du välja Katalog i listrutan för att växla till katalogvisningsläge. När katalogen är synlig noterar du texten som visas tillsammans med DropDownList kontrollen i katalogens sidfot. Du kan klicka på knappen Ange egenskaper för zontext för att ändra egenskapens textvärde.

Kommentarer

När kataloggränssnittet först visas kan användarna välja en av CatalogPart kontrollerna, till exempel , som DeclarativeCatalogPartinnehåller WebPart eller andra serverkontroller som kan läggas till på webbsidan. Användaren väljer en eller flera kontroller och kan sedan använda DropDownList kontrollen i sidfotsområdet i katalogen och välja kontrollen WebPartZone på sidan där de valda serverkontrollerna ska placeras. Textvärdet för egenskapen SelectTargetZoneText visas tillsammans med DropDownList kontrollen som en enkel instruktion.

Värdet för den här egenskapen kan när den anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttributeglobalisering och lokalisering.

Gäller för

Se även