Process.CloseMainWindow Metode

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.Process.dll

Sumber:

Process.cs

Menutup proses yang memiliki antarmuka pengguna dengan mengirim pesan dekat ke jendela utamanya.

public:
 bool CloseMainWindow();

public bool CloseMainWindow ();

member this.CloseMainWindow : unit -> bool

Public Function CloseMainWindow () As Boolean

Mengembalikan

Boolean

true jika pesan penutup berhasil dikirim; false jika proses terkait tidak memiliki jendela utama atau jika jendela utama dinonaktifkan (misalnya jika dialog modal sedang ditampilkan).

Pengecualian

InvalidOperationException

Proses telah keluar.

-atau-

Tidak ada proses yang terkait dengan objek ini Process .

Contoh

Contoh berikut memulai instans Notepad. Kemudian mengambil penggunaan memori fisik dari proses terkait pada interval 2 detik selama maksimum 10 detik. Contoh mendeteksi apakah proses keluar sebelum 10 detik telah berlalu. Contoh menutup proses jika masih berjalan setelah 10 detik.

#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

Keterangan

Ketika proses dijalankan, perulangan pesannya dalam status tunggu. Perulangan pesan dijalankan setiap kali pesan Windows dikirim ke proses oleh sistem operasi. Panggilan CloseMainWindow mengirimkan permintaan untuk menutup jendela utama, yang, dalam aplikasi yang terbentuk dengan baik, menutup jendela anak dan mencabut semua perulangan pesan yang sedang berjalan untuk aplikasi. Permintaan untuk keluar dari proses dengan memanggil CloseMainWindow tidak memaksa aplikasi untuk berhenti. Aplikasi dapat meminta verifikasi pengguna sebelum berhenti, atau dapat menolak untuk berhenti. Untuk memaksa aplikasi berhenti, gunakan Kill metode . Perilaku CloseMainWindow identik dengan pengguna yang menutup jendela utama aplikasi menggunakan menu sistem. Oleh karena itu, permintaan untuk keluar dari proses dengan menutup jendela utama tidak memaksa aplikasi untuk segera berhenti.

Data yang diedit oleh proses atau sumber daya yang dialokasikan untuk proses dapat hilang jika Anda memanggil Kill. Kill menyebabkan penghentian proses abnormal, dan harus digunakan hanya jika perlu. CloseMainWindow memungkinkan penghentian proses secara teratur dan menutup semua jendela, sehingga lebih disukai untuk aplikasi dengan antarmuka. Jika CloseMainWindow gagal, Anda dapat menggunakan Kill untuk mengakhiri proses. Kill adalah satu-satunya cara untuk mengakhiri proses yang tidak memiliki antarmuka grafis.

Anda dapat memanggil Kill dan CloseMainWindow hanya untuk proses yang berjalan di komputer lokal. Anda tidak dapat menyebabkan proses pada komputer jarak jauh keluar. Anda hanya bisa melihat informasi untuk proses yang berjalan pada komputer jarak jauh.