Istruzione With...End With (Visual Basic)
Aggiornamento: novembre 2007
Consentono di eseguire una serie di istruzioni contenenti riferimenti ripetuti a un unico oggetto o struttura.
With object
[ statements ]
End With
Parti
object
Obbligatoria. Variabile o espressione. Consente di restituire qualsiasi tipo di dati, compresi i tipi di base.statements
Facoltativa. Una o più istruzioni inserite tra With e End With in esecuzione su object.End With
Obbligatoria. Termina la definizione del blocco With.
Note
With...End With consente di eseguire una serie di istruzioni su un oggetto specificato senza che sia necessario riqualificare il nome dell'oggetto. Se il percorso di qualificazione relativo all'oggetto è lungo, è possibile utilizzare With...End With per migliorare le prestazioni. Un blocco With riduce, inoltre, l'inserimento ripetitivo del percorso di qualificazione e il rischio di errori di digitazione di uno degli elementi.
Per modificare varie proprietà in un singolo oggetto, ad esempio, è possibile inserire le istruzioni di assegnazione delle proprietà all'interno dell'istruzione With...End With, facendo riferimento all'oggetto una sola volta anziché in ogni assegnazione.
Regole
Tipi di dati. Il tipo di dati object può essere qualsiasi tipo di classe o struttura o anche un tipo elementare di Visual Basic come Integer. .NET Framework supporta tutti i tipi elementari con classi o strutture, che dispongono di membri ai quali è possibile accedere all'interno di un blocco With.
Dichiarazione. È necessario dichiarare object prima di accedere al blocco With. Non è possibile dichiararlo nell'istruzione With.
Numero di iterazioni. Un blocco With non è una costruzione iterativa. A meno che all'interno del blocco non sia presente un ciclo, le istruzioni vengono eseguite una sola volta.
Strutture nidificate. È possibile nidificare strutture With...End With inserendo una struttura all'interno di un'altra. Per un esempio, vedere Procedura: eseguire più operazioni su un oggetto.
Tuttavia, poiché i membri delle istruzioni di livello inferiore sono nascosti nelle istruzioni di livello superiore, è necessario fornire un riferimento completo all'oggetto qualificato in un blocco With interno per ogni membro di un oggetto in un blocco With esterno.
È inoltre possibile nidificare strutture di controllo di tipo diverso inserendone una all'interno di un altra. Per ulteriori informazioni, vedere Strutture di controllo nidificate.
Trasferimento all'esterno della struttura. Visual Basic non supporta Istruzione Exit (Visual Basic) per trasferire il controllo all'esterno di un blocco With. Se si desidera uscire prima che tutte le istruzioni siano state eseguite, inserire un'etichetta nell'istruzione End With e utilizzare Istruzione GoTo per diramare all'etichetta. Per ulteriori informazioni, vedere Procedura: etichettare le istruzioni.
Non è possibile trasferire il controllo dall'esterno di un blocco With al suo interno o viceversa. È possibile chiamare una routine dall'interno del blocco, ma il controllo torna all'istruzione successiva.
Accesso ad altri oggetti. Dopo aver inserito un blocco With, l'oggetto object non può essere riassegnato sino a quando non è stata superata l'istruzione End With. L'accesso ai metodi e alle proprietà senza qualifica è quindi limitato al solo oggetto specificato. Metodi e proprietà di altri oggetti possono essere utilizzati ma è necessario qualificarli con i relativi nomi di oggetto.
Esempio
Nell'esempio riportato di seguito il blocco With viene utilizzato per eseguire una serie di istruzioni su un singolo oggetto. Nell'esempio si presuppone che l'oggetto testObject sia già stato creato e che le proprietà a cui fa riferimento siano esposte.
With testObject
.Height = 100
.Text = "Hello, World"
.ForeColor = System.Drawing.Color.Green
.Font = New System.Drawing.Font(.Font, _
System.Drawing.FontStyle.Bold)
End With
Parola chiave With negli inizializzatori di oggetto
Visual Basic 2008 introduce un nuovo utilizzo di With negli inizializzatori di oggetto. Per ulteriori informazioni ed esempi, vedere Inizializzatori di oggetto: tipi denominati e tipi anonimi e Tipi anonimi.
Vedere anche
Attività
Procedura: eseguire più operazioni su un oggetto
Procedura: etichettare le istruzioni
Concetti
Strutture di controllo nidificate
Inizializzatori di oggetto: tipi denominati e tipi anonimi