Process.CloseMainWindow Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.Process.dll

Source:

Process.cs

Cierra un proceso que contiene una interfaz de usuario mediante el envío de un mensaje de cierre a su ventana principal.

public:
 bool CloseMainWindow();

public bool CloseMainWindow ();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Devoluciones

Boolean

Es true si el mensaje de cierre se envió correctamente; es false si el proceso asociado no tiene una ventana principal o si la ventana principal está deshabilitada (por ejemplo, si se está mostrando un cuadro de diálogo modal).

Excepciones

InvalidOperationException

El proceso ya se cerró.

o bien

No hay ningún proceso asociado a este objeto Process.

Ejemplos

En el ejemplo siguiente se inicia una instancia del Bloc de notas. A continuación, recupera el uso de memoria física del proceso asociado en intervalos de 2 segundos durante un máximo de 10 segundos. En el ejemplo se detecta si el proceso se cierra antes de que hayan transcurrido 10 segundos. En el ejemplo se cierra el proceso si se sigue ejecutando después de 10 segundos.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   try
   {
      Process^ myProcess;
      myProcess = Process::Start(  "Notepad.exe" );
      
      // Display physical memory usage 5 times at intervals of 2 seconds.
      for ( int i = 0; i < 5; i++ )
      {
         if (  !myProcess->HasExited )
         {
            
            // Discard cached information about the process.
            myProcess->Refresh();
            
            // Print working set to console.
            Console::WriteLine( "Physical Memory Usage : {0}", myProcess->WorkingSet.ToString() );
            
            // Wait 2 seconds.
            Thread::Sleep( 2000 );
         }
         else
         {
            break;
         }

      }
      myProcess->CloseMainWindow();
      
      // Free resources associated with process.
      myProcess->Close();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised: " );
      Console::WriteLine( e->Message );
   }

}

using System;
using System.ComponentModel;
using System.Diagnostics;
using System.IO;
using System.Threading;

namespace ProcessSample
{
    class MyProcessClass
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = Process.Start("Notepad.exe"))
                {
                    // Display physical memory usage 5 times at intervals of 2 seconds.
                    for (int i = 0; i < 5; i++)
                    {
                        if (!myProcess.HasExited)
                        {
                            // Discard cached information about the process.
                            myProcess.Refresh();
                            // Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}");
                            // Wait 2 seconds.
                            Thread.Sleep(2000);
                        }
                        else
                        {
                            break;
                        }
                    }

                    // Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow();
                    // Free resources associated with process.
                    myProcess.Close();
                }
            }
            catch (Exception e) when (e is Win32Exception || e is FileNotFoundException)
            {
                Console.WriteLine("The following exception was raised: ");
                Console.WriteLine(e.Message);
            }
        }
    }
}

Imports System.ComponentModel
Imports System.Diagnostics
Imports System.IO
Imports System.Threading

Namespace Process_Sample
    Class MyProcessClass

        Public Shared Sub Main()
            Try
                Using myProcess = Process.Start("Notepad.exe")
                    ' Display physical memory usage 5 times at intervals of 2 seconds.
                    Dim i As Integer
                    For i = 0 To 4
                        If Not myProcess.HasExited Then

                            ' Discard cached information about the process.
                            myProcess.Refresh()
                            ' Print working set to console.
                            Console.WriteLine($"Physical Memory Usage: {myProcess.WorkingSet}")
                            ' Wait 2 seconds.
                            Thread.Sleep(2000)
                        Else
                            Exit For
                        End If

                    Next i

                    ' Close process by sending a close message to its main window.
                    myProcess.CloseMainWindow()
                    ' Free resources associated with process.
                    myProcess.Close()
                End Using
            Catch e As Exception When TypeOf e Is Win32Exception Or TypeOf e Is FileNotFoundException
                Console.WriteLine("The following exception was raised: ")
                Console.WriteLine(e.Message)
            End Try
        End Sub
    End Class
End Namespace 'Process_Sample

Comentarios

Cuando se ejecuta un proceso, su bucle de mensajes está en un estado de espera. El bucle de mensajes se ejecuta cada vez que el sistema operativo envía un mensaje de Windows al proceso. La llamada CloseMainWindow a envía una solicitud para cerrar la ventana principal, que, en una aplicación bien formada, cierra las ventanas secundarias y revoca todos los bucles de mensajes en ejecución de la aplicación. La solicitud para salir del proceso mediante una llamada CloseMainWindow a no obliga a la aplicación a salir. La aplicación puede solicitar la comprobación del usuario antes de salir o rechazarlo. Para forzar que la aplicación se cierre, use el Kill método . El comportamiento de es idéntico al de CloseMainWindow un usuario que cierra la ventana principal de una aplicación mediante el menú del sistema. Por lo tanto, la solicitud para salir del proceso cerrando la ventana principal no obliga a la aplicación a salir inmediatamente.

Los datos editados por el proceso o los recursos asignados al proceso se pueden perder si llama a Kill. Kill provoca una terminación de proceso anómala y solo se debe usar cuando sea necesario. CloseMainWindow habilita una terminación ordenada del proceso y cierra todas las ventanas, por lo que es preferible para las aplicaciones con una interfaz. Si CloseMainWindow se produce un error, puede usar Kill para finalizar el proceso. Kill es la única manera de finalizar procesos que no tienen interfaces gráficas.

Puede llamar a Kill y CloseMainWindow solo para los procesos que se ejecutan en el equipo local. No puede hacer que los procesos de los equipos remotos salgan. Solo puede ver información de los procesos que se ejecutan en equipos remotos.