WebPartManager.DisplayMode Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

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 la modalità di visualizzazione attiva per una pagina Web che contiene controlli Web part.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ DisplayMode { System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ get(); void set(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value); };

[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartDisplayMode DisplayMode { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayMode with get, set

Public Overridable Property DisplayMode As WebPartDisplayMode

Valore della proprietà

WebPartDisplayMode

Classe WebPartDisplayMode che determina la modalità di visualizzazione di una pagina.

Attributi: BrowsableAttribute

Eccezioni

ArgumentNullException

L'oggetto WebPartDisplayMode assegnato alla proprietà è null.

ArgumentException

L'oggetto WebPartDisplayMode assegnato alla proprietà non fa parte delle modalità di visualizzazione supportate.

-oppure- L'oggetto WebPartDisplayMode assegnato alla proprietà è disabilitato.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso a livello di codice della DisplayMode proprietà. Dopo aver caricato la pagina in un browser, è possibile usare i pulsanti nella parte inferiore della pagina per cambiare le modalità di visualizzazione. La pagina è in modalità di esplorazione per impostazione predefinita quando viene caricata. Se si passa alla modalità di progettazione, è possibile trascinare i controlli server da una zona a un'altra o disporre due controlli all'interno di una zona. Se si passa alla modalità di modifica, è possibile fare clic sul menu verbi nell'intestazione di uno dei controlli server, selezionare Modifica e modificare il controllo usando l'interfaccia utente di modifica fornita.

Nota

Il passaggio tra le modalità di visualizzazione in un'applicazione Web part è molto comune e potrebbe essere necessario fornire un modo coerente e riutilizzabile per eseguire questa operazione in tutte le pagine che contengono controlli Web part. Per un esempio di controllo utente che modifica le modalità di visualizzazione e che possono essere riutilizzate in molte pagine, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina Web part.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  protected void Button1_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.DesignDisplayMode;
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.EditDisplayMode;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.DesignDisplayMode
  End Sub
  
  Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.EditDisplayMode
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

Commenti

Una pagina che contiene controlli Web part è sempre in una delle diverse modalità di visualizzazione possibili. Per informazioni dettagliate sulle modalità di visualizzazione, vedere modalità di visualizzazione della pagina Web part.

La WebPartManager classe crea le modalità di visualizzazione per una pagina Web. Usando la classe di baseWebPartDisplayMode, il WebPartManager controllo crea diversi oggetti modalità di visualizzazione standard che possono essere usati nelle pagine che contengono controlli Web part. Queste modalità di visualizzazione standard sono descritte nella panoramica della WebPartDisplayMode classe.

Il WebPartManager controllo gestisce anche le modalità di visualizzazione per le pagine che usano controlli Web part. Usando la DisplayMode proprietà, il WebPartManager controllo mantiene un riferimento alla modalità di visualizzazione corrente in una pagina. È anche possibile usare la DisplayMode proprietà per passare a una pagina in diverse modalità di visualizzazione. Per un esempio di modifica delle modalità di visualizzazione in una pagina che usa controlli Web part, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina Web part.

Come parte della gestione della modalità di visualizzazione, il WebPartManager controllo fornisce anche eventi e gestori eventi relativi alle modalità di visualizzazione, ad esempio il metodo e il OnDisplayModeChanging OnDisplayModeChanged metodo. Questi metodi forniscono un meccanismo per personalizzare il comportamento di una pagina e anche per l'aggiunta di una modalità di visualizzazione personalizzata.

Si applica a