Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MessageBox.Show (IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

 

Data di pubblicazione: ottobre 2016

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti l'icona, il pulsante predefinito e le opzioni specificati.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons,
	MessageBoxIcon icon,
	MessageBoxDefaultButton defaultButton,
	MessageBoxOptions options
)

Parametri

owner
Type: System.Windows.Forms.IWin32Window

Implementazione di IWin32Window che sarà proprietaria della finestra di dialogo modale.

text
Type: System.String

Testo da visualizzare nella finestra di messaggio.

caption
Type: System.String

Testo da visualizzare nella barra del titolo della finestra di messaggio.

buttons
Type: System.Windows.Forms.MessageBoxButtons

Uno dei valori di MessageBoxButtons che specifica i pulsanti da visualizzare nella finestra di messaggio.

icon
Type: System.Windows.Forms.MessageBoxIcon

Uno dei valori di MessageBoxIcon che specifica l'icona da visualizzare nella finestra di messaggio.

defaultButton
Type: System.Windows.Forms.MessageBoxDefaultButton

Uno dei valori di MessageBoxDefaultButton che specifica il pulsante predefinito per la finestra di messaggio.

options
Type: System.Windows.Forms.MessageBoxOptions

Uno dei valori di MessageBoxOptions che specifica le opzioni di visualizzazione e di associazione da usare per la finestra di messaggio. Per usare le impostazioni predefinite, è possibile passare il valore 0.

Valore restituito

Type: System.Windows.Forms.DialogResult

Uno dei valori di DialogResult.

Exception Condition
InvalidEnumArgumentException

buttons non è un membro di MessageBoxButtons.

-oppure-

icon non è un membro di MessageBoxIcon.

-oppure-

defaultButton non è un membro di MessageBoxDefaultButton.

InvalidOperationException

Si è verificato un tentativo di visualizzare il MessageBox in un processo che non è in esecuzione in modalità interattiva utente. Questa impostazione è specificata la SystemInformation.UserInteractive proprietà.

ArgumentException

options specificato sia DefaultDesktopOnly e ServiceNotification.

-oppure-

options specificato DefaultDesktopOnly o ServiceNotification e un valore nel owner parametro. Queste due opzioni devono essere usate solo se si richiama la versione di questo metodo che non accetta un owner parametro.

-oppure-

buttons specificare una combinazione valida di MessageBoxButtons.

È possibile utilizzare il owner parametro per specificare un particolare oggetto che implementa il IWin32Window interfaccia, che verrà utilizzato come finestra di primo livello e il proprietario della finestra di dialogo. Una finestra di messaggio è una finestra di dialogo modale, ovvero che nessun input (clic del mouse o tastiera) può verificarsi, ad eccezione per gli oggetti nel form modale. Il programma deve nascondere o chiudere il form modale (in genere in risposta a un'operazione dell'utente) prima di input a un altro modulo.

È possibile configurare un massimo di tre pulsanti nella finestra di messaggio.

Esempio di codice seguente viene illustrato come visualizzare un MessageBox con le opzioni supportate da questo overload del metodo Show. Dopo aver verificato che una variabile stringa, ServerName, è vuota, viene visualizzato un MessageBox, viene offerta all'utente la possibilità di annullare l'operazione. Se il Show valore restituito del metodo restituisce Yes, il modulo che è visualizzato il MessageBox viene chiuso.


private void validateUserEntry2()
{

	// Checks the value of the text.

	if(serverName.Text.Length == 0)
	{

		// Initializes the variables to pass to the MessageBox.Show method.

		string message = "You did not enter a server name. Cancel this operation?";
		string caption = "No Server Name Specified";
		MessageBoxButtons buttons = MessageBoxButtons.YesNo;
		DialogResult result;

		// Displays the MessageBox.

		result = MessageBox.Show(this, message, caption, buttons,
			MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
			MessageBoxOptions.RightAlign);

		if(result == DialogResult.Yes)
		{

			// Closes the parent form.

			this.Close();

		}

	}

}

UIPermission

for safe subwindows to call this method. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.SafeSubWindows

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: