Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método MessageBox.Show (IWin32Window, String, String, MessageBoxButtons)

 

Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, a legenda e os botões especificados.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public static DialogResult Show(
	IWin32Window owner,
	string text,
	string caption,
	MessageBoxButtons buttons
)

Parâmetros

owner
Type: System.Windows.Forms.IWin32Window

Uma implementação de IWin32Window que possuirá a caixa de diálogo modal.

text
Type: System.String

O texto a ser exibido na caixa de mensagem.

caption
Type: System.String

O texto a ser exibido na barra de título da caixa de mensagem.

buttons
Type: System.Windows.Forms.MessageBoxButtons

Um dos valores MessageBoxButtons que especifica quais botões devem ser exibidos na caixa de mensagem.

Valor Retornado

Type: System.Windows.Forms.DialogResult

Um dos valores de DialogResult.

Exception Condition
InvalidEnumArgumentException

buttons não é membro de MessageBoxButtons.

InvalidOperationException

Foi feita uma tentativa de exibir o MessageBox em um processo que não está em execução no modo Interativo do Usuário. Isso é especificado pela propriedade SystemInformation.UserInteractive.

You can use the owner parameter to specify a particular object, which implements the T:System.Windows.Forms.IWin32Window interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

You can have a maximum of three buttons on the message box.

The following code example demonstrates how to display a T:System.Windows.Forms.MessageBox with the options supported by this overload of M:System.Windows.Forms.MessageBox.Show(System.String,System.String,System.Windows.Forms.MessageBoxButtons,System.Windows.Forms.MessageBoxIcon,System.Windows.Forms.MessageBoxDefaultButton,System.Windows.Forms.MessageBoxOptions,System.Boolean). After verifying that a string variable, ServerName, is empty, the example displays a T:System.Windows.Forms.MessageBox, offering the user the option to cancel the operation. If the M:System.Windows.Forms.MessageBox.Show(System.String,System.String,System.Windows.Forms.MessageBoxButtons,System.Windows.Forms.MessageBoxIcon,System.Windows.Forms.MessageBoxDefaultButton,System.Windows.Forms.MessageBoxOptions,System.Boolean) method's return value evaluates to F:System.Windows.Forms.DialogResult.Yes, the form that displayed the T:System.Windows.Forms.MessageBox is closed.

private void validateUserEntry5()
{

	// 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);

		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
Disponível desde 1.1
Retornar ao início
Mostrar: