Process.CloseMainWindow Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cierra un proceso que tiene una interfaz de usuario enviando un mensaje de cierre a su ventana principal.
public:
bool CloseMainWindow();public bool CloseMainWindow();member this.CloseMainWindow : unit -> boolPublic Function CloseMainWindow () As BooleanDevoluciones
true si el mensaje de cierre se envió correctamente; false si el proceso asociado no tiene una ventana principal o si la ventana principal está deshabilitada (por ejemplo, si se muestra un cuadro de diálogo modal).
Excepciones
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 a intervalos de 2 segundos durante un máximo de 10 segundos. En el ejemplo se detecta si el proceso se cierra antes de transcurridos 10 segundos. En el ejemplo se cierra el proceso si todavía se está ejecutando después de 10 segundos.
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);
}
}
}
}
open System.ComponentModel
open System.Diagnostics
open System.IO
open System.Threading
try
use myProcess = Process.Start "Notepad.exe"
// Display physical memory usage 5 times at intervals of 2 seconds.
let mutable i = 0
while i < 5 && not myProcess.HasExited do
// Discard cached information about the process.
myProcess.Refresh()
// Print working set to console.
printfn $"Physical Memory Usage: {myProcess.WorkingSet64}"
// Wait 2 seconds.
Thread.Sleep 2000
i <- i + 1
// Close process by sending a close message to its main window.
myProcess.CloseMainWindow() |> ignore
// Free resources associated with process.
myProcess.Close()
with
| :? Win32Exception
| :? FileNotFoundException as e ->
printfn "The following exception was raised: "
printfn $"{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 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 para 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 rechazar la salida. Para forzar la salida de la aplicación, use el Kill método . El comportamiento de es idéntico al de un usuario que cierra la ventana principal de CloseMainWindow 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 se llama a Kill. Kill provoca una terminación anómala del proceso 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 los 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.