Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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

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

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
Tipo: System.Windows.Forms.IWin32Window
Uma implementação de IWin32Window que será o proprietário da caixa de diálogo modal.
text
Tipo: System.String
O texto será exibido na caixa de mensagem.
caption
Tipo: System.String
O texto será exibido na barra de título da caixa de mensagem.
buttons
Tipo: System.Windows.Forms.MessageBoxButtons
Dentre as MessageBoxButtons valores que especifica quais botões serão exibidos na caixa de mensagem.

Valor de retorno

Tipo: System.Windows.Forms.DialogResult
Dentre as DialogResult valores.

ExceçãoCondição
InvalidEnumArgumentException

buttonsnão é um membro do MessageBoxButtons.

InvalidOperationException

Foi feita uma tentativa para exibir o MessageBox em um processo que não está sendo executado no modo usuário interativo. Isso é especificado pelo SystemInformation.UserInteractive propriedade.

Você pode usar o owner parâmetro para especificar um determinado objeto que implementa o IWin32Window interface, que servirá como a janela de nível superior e o proprietário da caixa de diálogo. Uma caixa de mensagem é uma caixa de diálogo modal, o que significa que nenhuma entrada (teclado ou mouse clique) pode ocorrer, exceto aos objetos no formulário modal. O programa deve ocultar ou fechar um formulário modal (geralmente em resposta a alguma ação do usuário) antes de entrada para outro formulário pode ocorrer.

Você pode ter no máximo três botões na caixa de mensagem.

O exemplo de código a seguir demonstra como exibir um MessageBox com as opções aceitas por essa sobrecarga do Show. Depois de verificar que uma variável de seqüência de caracteres, ServerName, está vazio, o exemplo exibe um MessageBox, oferecendo ao usuário a opção para cancelar a operação. Se a Show o valor de retorno do método é avaliada como Yes, o formulário exibido o MessageBox está fechado.


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

			}

		}

	}


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft