CatalogZoneBase.SelectTargetZoneText Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Overridable Property SelectTargetZoneText As StringValore della proprietà
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à in modo dichiarativo 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 per la prima volta 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 può quindi usare il DropDownList controllo nell'area piè di pagina del catalogo e scegliere il 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à, se impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttributeGlobalizzazione e localizzazione.
