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 (String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão e opções.

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

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

Parâmetros

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.
icon
Tipo: System.Windows.Forms.MessageBoxIcon
Dentre as MessageBoxIcon valores que especifica qual ícone será exibido na caixa de mensagem.
defaultButton
Tipo: System.Windows.Forms.MessageBoxDefaultButton
Dentre as MessageBoxDefaultButton valores que especifica o botão padrão para a caixa de mensagem.
options
Tipo: System.Windows.Forms.MessageBoxOptions
Dentre as MessageBoxOptions que especifica quais opções de exibição e a associação de valores serão usados para a caixa de mensagem. Você pode passar 0 se desejar usar os padrões.

Valor de retorno

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

ExceçãoCondição
InvalidEnumArgumentException

buttonsnão é um membro do MessageBoxButtons.

- ou -

iconnão é um membro do MessageBoxIcon.

- ou -

O defaultButton especificado não é membro do MessageBoxDefaultButton.

InvalidOperationException

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

ArgumentException

optionsespecificado, ambos DefaultDesktopOnly e ServiceNotification.

- ou -

buttonsespecificada uma combinação inválida de MessageBoxButtons.

Você pode ter um máximo de 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 uma MessageBox com um ícone de caixa pergunta, oferecendo ao usuário a opção de cancelar a operação. O exemplo usa o RightAlign membro do MessageBoxOptions enumeração para alinhar o texto para a borda direita da caixa de diálogo. Se o Show valor de retorno do método é avaliada como Yes, o formulário exibido o MessageBox está fechado.



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

			}

		}

	}



.NET Framework

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

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

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 de sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft