Form.ShowDialog()方法

可以使用此方法在应用程序中显示模式对话框。调用此方法时，直到关闭对话框后，才执行此方法后面的代码。可以将 DialogResult 值之一分配给对话框，方法是将该值分配给窗体上 Button 的 DialogResult 属性或通过使用代码设置窗体的 DialogResult 属性。此方法随后返回该值。可以使用此返回值确定如何处理对话框中发生的操作。例如，如果关闭了对话框，并通过此方法返回了 DialogResult.Cancel 值，则可防止执行在调用 ShowDialog 之后的代码。

当窗体显示为模式对话框时，单击“关闭”按钮（窗体右上角带 X 的按钮）会隐藏窗体并将 DialogResult 属性设置为 DialogResult.Cancel。与无模式窗体不同，当用户单击对话框的关闭窗体按钮或设置 DialogResult 属性的值时，.NET Framework 不调用 Close 方法。窗体转而可以隐藏并可重新显示，而不用创建该对话框的新实例。因为未关闭显示为对话框的窗体，所以在您的应用程序不再需要该窗体时，必须调用该窗体的 Dispose 方法。

ShowDialog 方法的此版本使您得以指定将拥有所显示的对话框的特定窗体或控件。如果使用此方法的没有参数的版本，则显示的对话框将自动归应用程序的当前活动窗口所有。

示例
下面的代码示例将一个窗体显示为模式对话框并计算该对话框的返回值，然后确定是否读取该对话框窗体上 TextBox 控件的值。此示例要求已创建了一个名为 Form2 的 Form，并且它包含一个名为 TextBox1 的 TextBox 控件。该示例使用指定对话框所有者的 ShowDialog 版本。

public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}