Procedura dettagliata: debug di controlli di Windows Form personalizzati in fase di progettazione
Aggiornamento: novembre 2007
Quando si crea un controllo personalizzato, è spesso necessario eseguire il debug del comportamento in fase di progettazione specialmente se per il controllo si sta creando una finestra di progettazione personalizzata. Per informazioni dettagliate, vedere Procedura dettagliata: creazione di un controllo di Windows Form che usufruisca delle funzionalità offerte da Visual Studio in fase di progettazione.
È possibile eseguire il debug dei controlli personalizzati utilizzando Visual Studio esattamente come per qualsiasi altra classe .NET Framework. La differenza consiste nel fatto che si eseguirà il debug dell'istanza separata di Visual Studio con il codice del controllo personalizzato in esecuzione.
Di seguito sono elencate le attività illustrate nella procedura dettagliata:
Creazione di un progetto Windows Form per contenere il controllo personalizzato
Creazione di un progetto di libreria di controlli
Aggiunta di una proprietà al controllo personalizzato
Aggiunta del controllo personalizzato al form host
Impostazione del progetto per il debug in fase di progettazione
Debug del controllo personalizzato in fase di progettazione
Al termine, si saranno acquisite le informazioni sulle attività necessarie per l'esecuzione del debug del comportamento in fase di progettazione di un controllo personalizzato.
Nota: |
---|
È possibile che le finestre di dialogo e i comandi di menu visualizzati varino da quelli descritti nella Guida in linea a seconda delle impostazioni attive o dell'edizione del programma Per modificare le impostazioni, scegliere Importa/esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio. |
Creazione del progetto
Il primo passaggio consiste nella creazione del progetto di applicazione. Il progetto verrà utilizzato per generare l'applicazione che contiene il controllo personalizzato.
Per creare il progetto
- Creare un progetto Applicazione Windows chiamato "DebuggingExample". Per informazioni dettagliate, vedere Procedura: creare un progetto applicazione Windows.
Creazione di un progetto di libreria di controlli
Il passaggio successivo consiste nella creazione del progetto di libreria di controlli e impostazione del controllo personalizzato.
Per creare il progetto di libreria di controlli
Aggiungere alla soluzione un progetto Libreria di controlli Windows. Per informazioni dettagliate, vedere Finestra di dialogo Aggiungi nuovo progetto. Assegnare al progetto il nome "DebugControlLibrary".
Aggiungere un nuovo elemento UserControl al progetto DebugControlLibrary. Per informazioni dettagliate, vedere Procedura: aggiungere elementi di progetto nuovi. Assegnare al nuovo file di origine il nome di base "DebugControl".
Utilizzando Esplora soluzioni, eliminare il controllo predefinito del progetto cancellando il file di codice con il nome di base "UserControl1". Per informazioni dettagliate, vedere Procedura: rimuovere, eliminare ed escludere elementi.
Generare la soluzione.
Verifica
A questo punto il controllo personalizzato sarà visibile nella Casella degli strumenti.
Per verificare lo stato dell'attività
- Individuare la nuova scheda Componenti DebugControlLibrary e selezionarla. Una volta aperta, sarà possibile osservare che il controllo è presente nell'elenco come DebugControl con accanto l'icona predefinita.
Aggiunta di una proprietà al controllo personalizzato
Per verificare che il codice del controllo personalizzato viene eseguito in fase di progettazione, si aggiungerà una proprietà e si imposterà un punto di interruzione nel codice per implementare la proprietà.
Per aggiungere una proprietà al controllo personalizzato
Aprire DebugControl nell'editor di codice. Aggiungere il seguente codice alla definizione della classe.
Private demoStringValue As String = Nothing <BrowsableAttribute(true)> Public Property DemoString() As String Get Return Me.demoStringValue End Get Set(ByVal value As String) Me.demoStringValue = value End Set End Property
private string demoStringValue = null; [Browsable(true)] public string DemoString { get { return this.demoStringValue; } set { demoStringValue = value; } }
Generare la soluzione.
Aggiunta del controllo personalizzato al form host
Per eseguire il debug del comportamento in fase di progettazione del controllo personalizzato, si inserirà un'istanza della classe del controllo personalizzato in un form host.
Per aggiungere il controllo personalizzato al form host
Nel progetto "DebuggingExample", aprire Form1 in Progettazione Windows Form.
Nella Casella degli strumenti, aprire la scheda Componenti DebugControlLibrary e trascinare un'istanza di DebugControl nel form.
Individuare la proprietà personalizzata DemoString nella finestra Proprietà. È possibile modificarne il valore in modo analogo a quello di qualsiasi altra proprietà. Quando si seleziona la proprietà DemoString, viene visualizzata una stringa descrittiva nella parte inferiore della finestra Proprietà.
Impostazione del progetto per il debug in fase di progettazione
Per eseguire il debug del comportamento in fase di progettazione del controllo personalizzato, si eseguirà il debug dell'istanza separata di Visual Studio con il codice del controllo personalizzato in esecuzione.
Per impostare il progetto per il debug in fase di progettazione
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul progetto DebugControlLibrary e scegliere Proprietà.
Nella finestra della proprietà DebugControlLibrary selezionare la scheda Debug.
Nella sezione Azione di avvio, selezionare Avvia programma esterno. Verrà eseguito il debug di un'istanza separata di Visual Studio, quindi fare clic sul pulsante con i puntini di sospensione () per cercare l'IDE di Visual Studio. Il nome del file eseguibile è devenv.exe e, se è stato installato nel percorso predefinito, il relativo percorso %programfiles%\Microsoft Visual Studio 9.0\Common7\IDE\devenv.exe.
Scegliere OK per chiudere la finestra di dialogo.
Fare clic con il pulsante destro del mouse sul progetto DebugControlLibrary e scegliere Imposta come progetto di avvio per attivare la configurazione di debug.
Debug del controllo personalizzato in fase di progettazione
A questo punto è possibile eseguire il debug del controllo personalizzato come fosse in esecuzione in modalità di progettazione. Quando si avvia la sessione di debug, viene creata una nuova istanza di Visual Studio che verrà utilizzata per caricare la soluzione "DebuggingExample". Quando si apre Form1 in Progettazione Windows Form, un'istanza del controllo personalizzato viene creata ed eseguita.
Per eseguire il debug del controllo personalizzato in fase di progettazione
Aprire il file di origineDebugControl nell'editor di codice e inserire un punto di interruzione nella funzione di accesso Set della proprietà DemoString.
Premere F5 per avviare la sessione di debug. Si noti che verrà creata una nuova istanza di Visual Studio. È possibile distinguere le istanze in due modi:
L'istanza di debug contiene la parola In esecuzione nella barra del titolo.
Il pulsante Avvia dell'istanza di debug è disattivato nella barra degli strumenti Debug.
Il punto di interruzione è impostato nell'istanza di debug.
Nella nuova istanza di Visual Studio, aprire la soluzione "DebuggingExample". È possibile individuare facilmente la soluzione selezionando Progetti recenti dal menu File. Il file di soluzione "DebuggingExample.sln" sarà il file utilizzato più di recente nell'elenco.
Aprire Form1 in Progettazione Windows Form e selezionare il controllo DebugControl.
Modificare il valore della proprietà DemoString. Si noti che, eseguita la modifica, l'istanza di debug di Visual Studio acquisisce lo stato attivo e l'esecuzione si interrompe al punto di interruzione. La funzione di accesso della proprietà viene eseguita tramite un'unica procedura come si farebbe per qualsiasi altro codice.
Una volta terminata la sessione di debug, è possibile uscire chiudendo l'istanza host di Visual Studio o facendo clic sul pulsante Termina debug nell'istanza di debug.
Passaggi successivi
Dopo aver eseguito il debug dei controlli personalizzati in fase di progettazione, vi sono diverse possibilità per espandere l'interazione del controllo con l'IDE di Visual Studio.
È possibile utilizzare la proprietà DesignMode della classe Component per scrivere il codice che verrà eseguito solo in fase di progettazione. Per informazioni dettagliate, vedere DesignMode.
Alle proprietà del controllo si possono applicare diversi attributi per gestire l'interazione del controllo personalizzato con la finestra di progettazione. Tali attributi si trovano nello spazio dei nomi System.ComponentModel.
È possibile scrivere una finestra di progettazione personalizzata per il controllo personalizzato. In tal modo si ottiene il controllo completo della fase di progettazione utilizzando l'infrastruttura di progettazione estendibile esposta da Visual Studio. Per informazioni dettagliate, vedere Procedura dettagliata: creazione di un controllo di Windows Form che usufruisca delle funzionalità offerte da Visual Studio in fase di progettazione.
Vedere anche
Attività
Procedura: accedere ai servizi per la fase di progettazione
Procedura: accedere al supporto in fase di progettazione in Windows Form