MessageBox Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

kullanıcıya ileti sunan iletişim kutusu olarak da bilinen bir ileti penceresi görüntüler. Kullanıcı kapatana kadar uygulamadaki diğer eylemleri engelleyen kalıcı bir penceredir. , MessageBox kullanıcıyı bilgilendiren ve bildiren metinler, düğmeler ve simgeler içerebilir.

public ref class MessageBox

public class MessageBox

type MessageBox = class

Public Class MessageBox

Devralma

Object

MessageBox

Örnekler

Aşağıdaki kod örneği, bir MessageBox içindeki TextBoxeksik girişi kullanıcıya bildirmek için nasıl kullanılacağını gösterir. Bu örnek, yönteminin üzerinde ServerName adlı mevcut bir TextBox formdan çağrılmış olmasını gerektirir.

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

Aşağıdaki kod örneği, kullanıcıya evet veya hayır sorusu sormayı ve yanıtı temel alarak karar verme işlemini gösterir.

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

Açıklamalar

Sınıfının yeni bir örneğini MessageBox oluşturamazsınız. İleti kutusunu görüntülemek için yöntemini MessageBox.Showçağırınstatic. İleti kutusunda görüntülenen başlık, ileti, düğme ve simgeler, bu yönteme geçirdiğiniz parametreler tarafından belirlenir.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
Show(IWin32Window, String)	Belirtilen nesnenin önünde ve belirtilen metinle birlikte bir ileti kutusu görüntüler.
Show(IWin32Window, String, String)	Belirtilen nesnenin önünde, belirtilen metin ve resim yazısıyla birlikte bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons)	Belirtilen nesnenin önünde ve belirtilen metin, resim yazısı ve düğmelerle bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Belirtilen nesnenin önünde ve belirtilen metin, resim yazısı, düğmeler ve simge içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Belirtilen nesnenin önünde ve belirtilen metin, resim yazısı, düğmeler, simge ve varsayılan düğmeyi içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Belirtilen nesnenin önünde ve belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme ve seçenekleri içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Belirtilen Yardım dosyasını kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Belirtilen Yardım dosyasını ve HelpNavigatorkullanarak belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Belirtilen Yardım dosyasını HelpNavigator, ve Yardım konusunu kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String)	Belirtilen metinle bir ileti kutusu görüntüler.
Show(String, String)	Belirtilen metin ve resim yazısı içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons)	Belirtilen metin, resim yazısı ve düğmeler içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Belirtilen metin, resim yazısı, düğmeler ve simge içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Belirtilen metin, resim yazısı, düğmeler, simge ve varsayılan düğmeyi içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme ve seçenekleri içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Belirtilen Yardım dosyasını kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Belirtilen Yardım dosyasını ve HelpNavigatorkullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Belirtilen Yardım dosyasını HelpNavigator, ve Yardım konusunu kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Belirtilen Yardım dosyasını ve Yardım anahtar sözcüğünü kullanarak, belirtilen metin, resim yazısı, düğmeler, simge, varsayılan düğme, seçenekler ve Yardım düğmesini içeren bir ileti kutusu görüntüler.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)