MessageBox Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Visar ett meddelandefönster, även kallat en dialogruta, som visar ett meddelande för användaren. Det är ett modalt fönster som blockerar andra åtgärder i programmet tills användaren stänger det. En MessageBox kan innehålla text, knappar och symboler som informerar och instruerar användaren.
public ref class MessageBox
public class MessageBox
type MessageBox = class
Public Class MessageBox
- Arv
-
MessageBox
Exempel
Följande kodexempel visar hur du använder en MessageBox för att informera användaren om en saknad post i en TextBox. Det här exemplet kräver att metoden anropas från ett befintligt formulär med namnet TextBoxServerName på.
private:
void validateUserEntry()
{
// 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;
System::Windows::Forms::DialogResult result;
// Displays the MessageBox.
result = MessageBox::Show( this, message, caption, buttons );
if ( result == ::DialogResult::Yes )
{
// Closes the parent form.
this->Close();
}
}
}
private void validateUserEntry()
{
// 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 = "Error Detected in Input";
MessageBoxButtons buttons = MessageBoxButtons.YesNo;
DialogResult result;
// Displays the MessageBox.
result = MessageBox.Show(message, caption, buttons);
if (result == System.Windows.Forms.DialogResult.Yes)
{
// Closes the parent form.
this.Close();
}
}
}
Private Sub ValidateUserEntry()
' Checks the value of the text.
If ServerName.Text.Length = 0 Then
' Initializes variables to pass to the MessageBox.Show method.
Dim Message As String = "You did not enter a server name. Cancel this operation?"
Dim Caption As String = "Error Detected in Input"
Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo
Dim Result As DialogResult
'Displays the MessageBox
Result = MessageBox.Show(Message, Caption, Buttons)
' Gets the result of the MessageBox display.
If Result = System.Windows.Forms.DialogResult.Yes Then
' Closes the parent form.
Me.Close()
End If
End If
End Sub
I följande kodexempel visas hur du ställer en ja- eller nejfråga till användaren och fattar ett beslut baserat på svaret.
private:
void Form1_FormClosing(Object^ sender, FormClosingEventArgs^ e)
{
// If the no button was pressed ...
if ((MessageBox::Show(
"Are you sure that you would like to close the form?",
"Form Closing", MessageBoxButtons::YesNo,
MessageBoxIcon::Question) == DialogResult::No))
{
// cancel the closure of the form.
e->Cancel = true;
}
}
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
const string message =
"Are you sure that you would like to close the form?";
const string caption = "Form Closing";
var result = MessageBox.Show(message, caption,
MessageBoxButtons.YesNo,
MessageBoxIcon.Question);
// If the no button was pressed ...
if (result == DialogResult.No)
{
// cancel the closure of the form.
e.Cancel = true;
}
}
Private Sub Form1_FormClosing( _
ByVal sender As System.Object, _
ByVal e As System.Windows.Forms.FormClosingEventArgs) _
Handles MyBase.FormClosing
Dim message As String = _
"Are you sure that you would like to close the form?"
Dim caption As String = "Form Closing"
Dim result = MessageBox.Show(message, caption, _
MessageBoxButtons.YesNo, _
MessageBoxIcon.Question)
' If the no button was pressed ...
If (result = DialogResult.No) Then
' cancel the closure of the form.
e.Cancel = True
End If
End Sub
Kommentarer
Du kan inte skapa en ny instans av MessageBox klassen. Om du vill visa en meddelanderuta anropar du static metoden MessageBox.Show. Rubriken, meddelandet, knapparna och ikonerna som visas i meddelanderutan bestäms av parametrar som du skickar till den här metoden.
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen och |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med hjälpknappen angiven hjälpfil och hjälpnyckelord. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) |
Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar, ikon, standardknapp och alternativ. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar, ikon och standardknapp. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) |
Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar och ikon. |
| Show(IWin32Window, String, String, MessageBoxButtons) |
Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext och knappar. |
| Show(IWin32Window, String, String) |
Visar en meddelanderuta framför det angivna objektet och med angiven text och bildtext. |
| Show(IWin32Window, String) |
Visar en meddelanderuta framför det angivna objektet och med den angivna texten. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen och |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med hjälpknappen angiven hjälpfil och hjälpnyckelord. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp och alternativ. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
Visar en meddelanderuta med angiven text, bildtext, knappar, ikon och standardknapp. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon) |
Visar en meddelanderuta med angiven text, bildtext, knappar och ikon. |
| Show(String, String, MessageBoxButtons) |
Visar en meddelanderuta med angiven text, bildtext och knappar. |
| Show(String, String) |
Visar en meddelanderuta med angiven text och bildtext. |
| Show(String) |
Visar en meddelanderuta med angiven text. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |