Il presente articolo è stato tradotto manualmente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.

Traduzione

Originale

Questo argomento non è stato ancora valutato - Valuta questo argomento

Metodo WebPartManager.GetGenericWebPart

.NET Framework 4

Altre versioni

Ottiene un riferimento all'istanza del controllo GenericWebPart che contiene un controllo server.

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

Sintassi

C++

public GenericWebPart GetGenericWebPart(
	Control control
)

Parametri

control: Tipo: System.Web.UI.Control
Controllo server presente in una classe WebPartZoneBase e che viene incluso come controllo figlio di un controllo GenericWebPart in fase di esecuzione.

Valore restituito

Tipo: System.Web.UI.WebControls.WebParts.GenericWebPart
Controllo GenericWebPart che include control come controllo figlio. Il metodo restituisce null se control non è incluso in un controllo GenericWebPart.

Eccezioni

Eccezione	Condizione
ArgumentNullException	control è null.

Note

In genere, gli sviluppatori posizionano nelle aree WebPartZoneBase due categorie di controlli che faranno parte delle applicazioni Web part: i controlli WebPart, che ereditano dalla classe di base WebPart e altri controlli server, che possono essere controlli ASP.NET standard, controlli personalizzati o controlli utente. Quando uno di questi controlli viene posizionato in un'area WebPartZoneBase, assume la funzionalità di un controllo WebPart. Il controllo WebPart è dotato di tale funzionalità in modo intrinseco, a differenza degli altri tipi di controlli server. Per consentire il funzionamento degli altri controlli server come controlli WebPart quando sono posizionati in un'area WebPartZoneBase, ASP.NET li include in un controllo GenericWebPart. Poiché il controllo GenericWebPart eredita direttamente dalla classe WebPart, fornisce ai relativi controlli figlio funzioni Web part vere e proprie.

In fase di esecuzione, gli sviluppatori spesso desiderano ottenere un riferimento al controllo GenericWebPart che contiene uno dei controlli server in un'area. Il metodo GetGenericWebPart consente loro di recuperare un riferimento al controllo GenericWebPart.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo GetGenericWebPart. L'esempio di codice contiene un controllo Calendar dichiarato all'interno di un'area WebPartZone. Il metodo Button1_Click determina per prima cosa la visualizzazione dell'ID del controllo Calendar in un'etichetta, quindi utilizza il metodo GetGenericWebPart per recuperare un riferimento al controllo GenericWebPart che include il calendario. L'ID del controllo GenericWebPart e l'ID del relativo controllo figlio (ovvero del controllo Calendar), sono visualizzati entrambi in una seconda etichetta.


<%@ 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)
  {
    Label1.Text = "<h2>Server Control</h2>";
    Label1.Text += "Server Control ID:  " + Calendar1.ID;
    Label2.Text = "<h2>GenericWebPart Control</h2>";
    GenericWebPart part = mgr.GetGenericWebPart(Calendar1);
    if (part != null)
    {
      Label2.Text +=
        "GenericWebPart ID:  " + part.ID + "<br />";
      Label2.Text +=
        "Underlying Control ID: " + part.ChildControl.ID;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Get GenericWebPart"
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" Text="" />
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
    </div>
    </form>
</body>
</html>

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0

Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Vedere anche

Riferimenti

WebPartManager Classe

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

GenericWebPart

Altre risorse

Controlli Web part ASP.NET

Il documento è risultato utile? Sì No

Non accurato

Incompleto

Ulteriori esempi di codice

La traduzione deve essere migliorata

(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI