CatalogZoneBase.SelectTargetZoneText Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ottiene o imposta il testo con il controllo nell'interfaccia utente del catalogo che consente agli utenti di scegliere a quale zona aggiungere i controlli selezionati.

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

Valore della proprietà

String

Stringa che contiene il testo da visualizzare con il controllo di selezione della zona. Una stringa specifica delle impostazioni cultura predefinita viene fornita da .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la SelectTargetZoneText proprietà dichiarativamente e a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio della panoramica della CatalogZoneBase classe.

Si noti che la prima parte dell'esempio di codice dichiara due <asp:catalogzone> elementi e la prima dichiara un valore per la SelectTargetZoneText proprietà.

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

Nella seconda parte dell'esempio di codice il valore della proprietà viene modificato a livello di SelectTargetZoneText codice.

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

Quando si carica la pagina in un browser, è possibile selezionare Catalogo dall'elenco a discesa per passare alla modalità di visualizzazione del catalogo. Quando il catalogo è visibile, prendere nota del testo visualizzato insieme al DropDownList controllo nel piè di pagina del catalogo. È possibile fare clic sul pulsante Imposta proprietà testo zona per modificare il valore di testo della proprietà.

Commenti

Quando viene visualizzata prima l'interfaccia utente del catalogo, gli utenti possono selezionare uno dei CatalogPart controlli, ad esempio DeclarativeCatalogPart, che contiene WebPart o altri controlli server che possono essere aggiunti alla pagina Web. L'utente seleziona uno o più controlli e quindi può usare il controllo nell'area piè di pagina del catalogo e scegliere il DropDownList WebPartZone controllo nella pagina in cui posizionare i controlli server selezionati. Il valore di testo della SelectTargetZoneText proprietà viene visualizzato insieme al DropDownList controllo come istruzione semplice.

Il valore di questa proprietà, quando impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttribute e Globalizzazione e Localizzazione.

Vedi anche

• controlli ASP.NET Web part