Condividi tramite


WebPartManager.DisplayMode Proprietà

Definizione

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à

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

Attributi

Eccezioni

L'oggetto WebPartDisplayMode assegnato alla proprietà è null.

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 modalità di visualizzazione. La pagina è in modalità di esplorazione per impostazione predefinita quando viene caricata. Se si passa alla modalità 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 può essere utile 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 delle pagine web part.

La WebPartManager classe crea le modalità di visualizzazione per una pagina Web. Usando la classe base WebPartDisplayMode , il WebPartManager controllo crea diversi oggetti in modalità di visualizzazione standard che possono essere utilizzati 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 utilizzano controlli Web part. Utilizzando la DisplayMode proprietà , il WebPartManager controllo mantiene un riferimento alla modalità di visualizzazione corrente in una pagina. È anche possibile utilizzare la DisplayMode proprietà per impostare una pagina in modalità di visualizzazione diverse. 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.

Nell'ambito della gestione della modalità di visualizzazione, il WebPartManager controllo fornisce anche eventi e gestori eventi relativi alle modalità di visualizzazione, ad esempio il OnDisplayModeChanged metodo e il OnDisplayModeChanging 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

Vedi anche