WebPartZoneBase.EmptyZoneText Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta un messaggio che viene visualizzato quando un controllo WebPartZoneBase non contiene controlli WebPart.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };
public override string EmptyZoneText { get; set; }
member this.EmptyZoneText : string with get, set
Public Overrides Property EmptyZoneText As String

Valore della proprietà

String

Stringa contenente il messaggio visualizzato in un'area vuota. Una stringa specifica delle impostazioni cultura predefinita viene fornita da .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo della EmptyZoneText proprietà in un WebPartZone controllo . Per l'esempio di codice completo, incluso il file di origine code-behind e la pagina aspx che contiene la zona in questo codice, vedere la panoramica della WebPartZoneBase classe.

Si noti che alla EmptyZoneText proprietà è assegnato un valore nel markup dichiarativo. Questo valore verrà visualizzato in WebPartZone2, dopo aver caricato la pagina in un browser, passare la pagina in modalità di visualizzazione progettazione e trascinare il controllo che visualizza la data da WebPartZone2 in WebPartZone1. Per altre informazioni sulla modifica delle modalità di visualizzazione in una pagina Web part, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina Web part.

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

Commenti

La EmptyZoneText proprietà esegue l'override della proprietà di base per distinguere i casi in cui la proprietà non è stata impostata e quelle in cui è stata impostata su una stringa vuota ("").

Se la proprietà non è stata impostata e la zona non contiene controlli, quando una pagina Web part entra in una modalità di visualizzazione in cui la zona è visibile, viene visualizzato un messaggio di testo specifico delle impostazioni cultura predefinito in un controllo vuotoWebPartZoneBase. Se il valore della EmptyZoneText proprietà è stato intenzionalmente impostato su una stringa vuota, non viene visualizzato alcun messaggio di testo in una zona vuota.

Si applica a

Vedi anche