Click here to Skip to main content
Click here to Skip to main content

A Single Instance Control Component in C#

, 1 Dec 2005
Rate this:
Please Sign up or sign in to vote.
A Single Instance control component which checks whether any instance of your application is running on the system.

Introduction

This article is on a Single Instance control component which checks whether any instance of your application is running on the system. One can use this component to check whether a particular application is running on the system, or to avoid multiple instances of your application running on the system. There are many methods with which you can prevent multiple instances of your application, like using complex Mutex class methods or some unmanaged code.

Here, I have used a simple Process class to check whether a particular process is running or not. Let's first discuss the InstanceControl component. The InstanceControl class is derived from the Component class of the .NET Framework, and this component has a method called IsAnyInstanceExist() which checks for a particular process running on the system and returns the status as true/false.

  • Namespace: InstConLib
  • Class: InstanceControl
  • Members:
    • InstanceControl() (constructor which takes the process name)
    • IsAnyInstanceExist() (checks for the process and returns a bool value)

A brief description about the component members:

  1. The InstanceControl(string) is the constructor of the InstanceControl component. The constructor takes a single parameter string which is the process name and stores it in the member variable.
  2. The IsAnyInstanceExist() method of the InstanceControl component returns true/false by checking to see if the process is running or not. This method uses the Process class (alias System.Diagnostics.Process) and the GetProcessesByName() method which, in turn, returns the array of processes running with that name.
using System;
using System.Diagnostics;
using System.ComponentModel;

namespace InstConLib { 
/* InstanceControlLib Class controls the instance */

  public class InstanceControl: Component
  {
    private string stProcName=null;
    /*constructor which holds the application name*/
    public InstanceControl(string ProcName)
    {
      stProcName=ProcName;
    }
    public bool IsAnyInstanceExist()
    {  /*process class GetProcessesByName() checks for particular
      process is currently running and returns array of processes
      with that name*/
      Process[] processes = Process.GetProcessesByName(stProcName);
      
        if(processes.Length != 1)
          return false; /*false no instance exist*/
        else 
          return true; /*true mean instance exist*/
    }
  } /*end of class*/
}/*end of namespace*/

Compile the above as a component library to produce a .dll file. Then, you can call this component in different clients like WinForms, WebForms or Console applications. I have used a simple console application to use this component. The client program calls the InstanceControl component and uses its method. In this example, I used two instances of the component. One which will check for the process that is not running, and the other which checks for the process which is running in the system.

Following is the code snippet of the client application:

//InstClient.cs 
using System;
using InstConLib;
public class InstClient
{
  public static void Main()
  { 
   //First Object which looks for testApp.exe process  
   //remember its not neccessary to give extention of process
   InstConLib.InstanceControl in1 = new InstConLib.InstanceControl("testApp");
   if(in1.IsAnyInstanceExist())
    Console.WriteLine("Alreading one instance is running");
   else
    Console.WriteLine("No Instance running"); 
    //Second Object which looks for Explorer.exe process  
    //remember its not neccessary to give extention of process
    InstConLib.InstanceControl in2 = 
       new InstConLib.InstanceControl("Explorer");

   if(in2.IsAnyInstanceExist())
     Console.WriteLine("Alreading one instance is running");
   else
     Console.WriteLine("No Instance running");
 }
}

OUTPUT:

D:\vstudio>InstClient
No Instance running
Alreading one instance is running

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Chandra Hundigam
Architect
United States United States
Chandra Hundigam has Master degree in Computer Application, Microsoft Certified Professional and Software Architect. He's significantly involved in enterprise application development and distributed object oriented system development using Microsoft .Net, Sun Java/J2EE technology to serve global giants in the Media, Finance, Mortgage and Software Industries.Presently working as Independent Software Consultant for a US-based company.His areas of interests are in emerging Technologies.

Comments and Discussions

 
GeneralFirst instance not in the process list [modified] PinmemberJohn.Jurisoo17-Sep-07 12:18 
GeneralNo client application code there!! Pinmembermbthe2nd27-Nov-05 13:43 
GeneralRe: No client application code there!! PinmemberChandra Hundigam2-Dec-05 7:41 
GeneralProcess class bug in .NET PinmemberallenLynx8-Sep-05 11:56 
GeneralMultiple AppDomains in single process Pinmembertstih15-Apr-03 23:00 
GeneralRe: Multiple AppDomains in single process PinmemberJohn Hills17-Apr-03 6:20 
GeneralMutex PinmemberAdam Turner15-Apr-03 19:29 
GeneralRe: Mutex Pinmembertstih15-Apr-03 23:03 
GeneralRe: Mutex PinmemberAlexander Werner17-Apr-03 6:14 
GeneralRe: Mutex PinmemberSanju Burkule21-Apr-03 13:23 
GeneralRe: Mutex PinmemberMach0052-Apr-04 7:24 
GeneralRe: Mutex PinmemberRequiem Sollar31-Jul-08 13:25 
GeneralNice Code PinsussAnonymous15-Apr-03 11:07 
GeneralRe: Nice Code PinmemberAK17-Apr-03 5:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.141216.1 | Last Updated 1 Dec 2005
Article Copyright 2003 by Chandra Hundigam
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid