Listing and Killing Processes with Visual Basic

Introduction

This article provides a simple example of how to use the System.Diagnostics.Process library to display a list of running processes, and to select and kill processes by their process name and ID.  It would not be a major trick to display additional information about the process using the same library or to kill processes by their ID or name alone rather than their name and ID but in this example, process names and IDs are used for display purposes and the purpose of killing a running process.

 
Figure 1:  Listing and Killing Processes by Process Name and ID

Getting Started

There is a single solution included with this download, the solution contains a Win Forms project called "ProcessKillerVB"; this project contains one form (Form1.vb) and all of the code required to display and kill processes is contained within that single form class.  If you open the attached project into Visual Studio 2008; you should see the following in the solution explorer:

 
Figure 2:  Solution Explorer

Code:  The Main Form

The main form contains all of the user interface elements necessary to display and update the list of currently running processes found on the user's machine.  It also contains a button handler which will kill a process by the process name.  You can also kill a process by its ID but in terms of readability, if the user is selecting the process, the process name is going to make a lot more sense to them than will the process ID.

The class begins with the normal and default imports:

Imports System.Diagnostics

The constructor calls a method called "UpdateProcessList" which is used to get and display a list of running processes; it will be described shortly.

Public Class Form1

 

 

    Public Sub New()

 

        ' This call is required by the Windows Form Designer.

        InitializeComponent()

 

        ' display the list of running processes

        UpdateProcessList()

 

    End Sub

The next bit of code is the UpdateProcessList function; this function clears the listbox of any existing entries and then loops through each of the current processes, adding the name and ID of each process to the list (as Process Name - ID).  At the end of the function, a status message is updated to display the current number of found processes.

''' <summary>

    ''' Loop through the list of running processes

    ''' and add each process name to the process

    ''' listbox

    ''' </summary>

    ''' <remarks></remarks>

    Private Sub UpdateProcessList()

 

        ' clear the existing list of any items

        lstProcesses.Items.Clear()

 

        ' loop through the running processes and add

        'each to the list

        Dim p As System.Diagnostics.Process

 

        For Each p In System.Diagnostics.Process.GetProcesses()

            lstProcesses.Items.Add(p.ProcessName & " - " & p.Id.ToString())

        Next

 

        lstProcesses.Sorted = True

 

        ' display the number of running processes in

        ' a status message at the bottom of the page

        tslProcessCount.Text = "Processes running: " & _

        lstProcesses.Items.Count.ToString()

 

    End Sub

The next bit of code in the application is the update button's click event handler; all it does is to call the UpdateProcessList function to update the contents of the listbox.

    ''' <summary>

    ''' Manually update the list of runnings

    ''' processes

    ''' </summary>

    ''' <param name="sender"></param>

    ''' <param name="e"></param>

    ''' <remarks></remarks>

    Private Sub btnUpdateProcessList_Click(ByVal sender As System.Object, _

                                           ByVal e As System.EventArgs) _

                                           Handles btnUpdateProcessList.Click

        UpdateProcessList()

 

    End Sub

The last bit of the code in the application is used to kill a running process.  Since you can have multiple processes with the same name, it was necessary to add in the ID along with the name in order to make some distinction between multiple instances of a single application, else, we would end up killing all running instances of the application which may or may not be desirable depending upon what you are doing.  If you do want to kill off all running instances of an application, disregard the ID and kill all running processes with the same process name.

In the kill button click event handler; we again loop through all of the running processes and we take the selected item from the process/ID list, and parse it into a string containing the process name and an integer value containing the ID.  If the current process (in the loop) matches on both the process name and process ID, the process is killed.  At the end, the handler calls the update method used to repopulate the listbox such that is displays the current list of active processes and their IDs.

    ''' <summary>

    ''' Kill the process selected in the process name

    ''' and ID listbox

    ''' </summary>

    ''' <param name="sender"></param>

    ''' <param name="e"></param>

    ''' <remarks></remarks>

    Private Sub btnKill_Click(ByVal sender As System.Object, _

                              ByVal e As System.EventArgs) _

                              Handles btnKill.Click

 

        If lstProcesses.SelectedItems.Count <= 0 Then

            MessageBox.Show("Click on a process name to select it.", "No Process

            Selected")

            Return

        End If

 

        ' loop through the running processes looking for a match

        ' by comparing process name to the name selected in the listbox

        Dim p As System.Diagnostics.Process

 

        For Each p In System.Diagnostics.Process.GetProcesses()

 

            Dim arr() As String = _

            lstProcesses.SelectedItem.ToString().Split("-")

 

            Dim sProcess As String = arr(0).Trim()

            Dim iId As Integer = Convert.ToInt32(arr(1).Trim())

 

            If p.ProcessName = sProcess And p.Id = iId Then

                p.Kill()

            End If

 

        Next

 

        ' update the list to show the killed process

        ' has been removed

        UpdateProcessList()

 

    End Sub 

End Class

That concludes the description of all of the code used in this example.

Summary

The article shows one approach that may be used to display a list of current processes, and to single out and kill a single process based upon both the process name and its ID.  One could also kill all instances of a particular process by killing all processes that match on name without giving any consideration to the process ID.  The approach shown allows for singling out specific instances of a process and killing it without taking down all other matching processes.