MessageBox.Show メソッド (String, String, MessageBoxButtons)
指定したテキスト、キャプション、およびボタンを表示するメッセージ ボックスを表示します。
Overloads Public Shared Function Show( _
ByVal text As String, _ ByVal caption As String, _ ByVal buttons As MessageBoxButtons _) As DialogResult
[C#]
public static DialogResult Show(stringtext,stringcaption,MessageBoxButtonsbuttons);
[C++]
public: static DialogResult Show(String* text,String* caption,MessageBoxButtonsbuttons);
[JScript]
public static function Show(
text : String,caption : String,buttons : MessageBoxButtons) : DialogResult;
パラメータ
- text
メッセージ ボックスに表示するテキスト。 - caption
メッセージ ボックスのタイトル バーに表示するテキスト。 - buttons
メッセージ ボックスに表示されるボタンを指定する MessageBoxButtons 値の 1 つ。
戻り値
DialogResult 値の 1 つ。
例外
例外の種類 | 条件 |
---|---|
InvalidEnumArgumentException | 指定した buttons パラメータが、 MessageBoxButtons のメンバではありません。 |
InvalidOperationException | ユーザー対話モード以外のモードで実行されているプロセスで、 MessageBox を表示しようとしました。このモードは、 SystemInformation.UserInteractive プロパティで指定されています。 |
解説
メッセージ ボックスには、最大 3 つのボタンを配置できます。
使用例
[Visual Basic, C#, C++] Show のこのオーバーロードでサポートされているオプションを使用して、 MessageBox を表示する方法の例を次に示します。この例では、文字列変数、 ServerName
が空であることを検査した後、操作をキャンセルするためのオプションをユーザーに提供する MessageBox を表示します。 Show メソッドの戻り値が Yes と評価された場合、 MessageBox を表示したフォームは閉じられます。
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 = "No Server Name Specified"
Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo
Dim Result As DialogResult
'Displays the MessageBox
Result = MessageBox.Show(Me, Message, Caption, Buttons)
' Gets the result of the MessageBox display.
If Result = DialogResult.Yes Then
' Closes the parent form.
Me.Close()
End If
End If
End Sub
[C#]
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;
DialogResult result;
// Displays the MessageBox.
result = MessageBox.Show(this, message, caption, buttons);
if(result == DialogResult.Yes)
{
// Closes the parent form.
this.Close();
}
}
}
[C++]
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 = S"You did not enter a server name. Cancel this operation?";
String* caption = S"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();
}
}
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- UIPermission (セーフ サブウィンドウでこのメソッドを呼び出すために必要なアクセス許可) UIPermissionWindow.SafeSubWindows (関連する列挙体)
参照
MessageBox クラス | MessageBox メンバ | System.Windows.Forms 名前空間 | MessageBox.Show オーバーロードの一覧 | MessageBoxButtons