Lire en anglais

Partager via


Process.GetProcessesByName Méthode

Définition

Crée un tableau de nouveaux composants Process et les associe à des ressources de processus existantes qui partagent toutes le nom de processus spécifié.

Surcharges

GetProcessesByName(String, String)

Crée un tableau de nouveaux composants Process et les associe à toutes les ressources de processus sur l'ordinateur distant qui partagent le nom de processus spécifié.

GetProcessesByName(String)

Crée un tableau de nouveaux composants Process et les associe à toutes les ressources de processus de l'ordinateur local qui partagent le nom de processus spécifié.

GetProcessesByName(String, String)

Source:
Process.Linux.cs
Source:
Process.Linux.cs
Source:
Process.Linux.cs

Crée un tableau de nouveaux composants Process et les associe à toutes les ressources de processus sur l'ordinateur distant qui partagent le nom de processus spécifié.

public static System.Diagnostics.Process[] GetProcessesByName (string? processName, string machineName);
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Diagnostics.Process[] GetProcessesByName (string? processName, string machineName);
public static System.Diagnostics.Process[] GetProcessesByName (string processName, string machineName);

Paramètres

processName
String

Nom convivial du processus.

machineName
String

Nom d'un ordinateur du réseau.

Retours

Tableau de type Process représentant les ressources de processus exécutant l'application ou le fichier spécifié.

Attributs

Exceptions

La syntaxe du paramètre machineName n’est pas valide. Sa longueur est peut-être égale à zéro (0).

Le paramètre machineName a la valeur null.

La plateforme du système d’exploitation ne prend pas en charge cette opération sur les ordinateurs distants.

La tentative de connexion à machineName a échoué.

- ou -

L’accès à l’API du compteur de performance pour obtenir des informations sur les processus présente des problèmes. Cette exception est propre à Windows NT, Windows 2000 et Windows XP.

Un problème s’est produit pendant l’accès à l’API système sous-jacente.

Exemples

L’exemple suivant récupère des informations sur le processus actuel, les processus en cours d’exécution sur l’ordinateur local, toutes les instances du Bloc-notes exécutés sur l’ordinateur local et un processus spécifique sur l’ordinateur local. Il récupère ensuite des informations pour les mêmes processus sur un ordinateur distant.

using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        void BindToRunningProcesses()
        {
            // Get the current process.
            Process currentProcess = Process.GetCurrentProcess();

            // Get all processes running on the local computer.
            Process[] localAll = Process.GetProcesses();

            // Get all instances of Notepad running on the local computer.
            // This will return an empty array if notepad isn't running.
            Process[] localByName = Process.GetProcessesByName("notepad");

            // Get a process on the local computer, using the process id.
            // This will throw an exception if there is no such process.
            Process localById = Process.GetProcessById(1234);

            // Get processes running on a remote computer. Note that this
            // and all the following calls will timeout and throw an exception
            // if "myComputer" and 169.0.0.0 do not exist on your local network.

            // Get all processes on a remote computer.
            Process[] remoteAll = Process.GetProcesses("myComputer");

            // Get all instances of Notepad running on the specific computer, using machine name.
            Process[] remoteByName = Process.GetProcessesByName("notepad", "myComputer");

            // Get all instances of Notepad running on the specific computer, using IP address.
            Process[] ipByName = Process.GetProcessesByName("notepad", "169.0.0.0");

            // Get a process on a remote computer, using the process id and machine name.
            Process remoteById = Process.GetProcessById(2345, "myComputer");
        }

        static void Main()
        {
            MyProcess myProcess = new MyProcess();
            myProcess.BindToRunningProcesses();
        }
    }
}

Remarques

Utilisez cette méthode pour créer un tableau de nouveaux Process composants et les associer à toutes les ressources de processus qui exécutent le même fichier exécutable sur l’ordinateur spécifié. Les ressources de processus doivent déjà exister sur l’ordinateur, car GetProcessesByName ne crée pas de ressources système, mais les associe plutôt à des composants générés par l’application Process . Un processName peut être spécifié pour un fichier exécutable qui n’est pas en cours d’exécution sur l’ordinateur local, de sorte que le tableau retourné par la méthode peut être vide.

Le nom du processus est un nom convivial pour le processus, tel qu’Outlook, qui n’inclut pas l’extension .exe ou le chemin d’accès. GetProcessesByName est utile pour obtenir et manipuler tous les processus associés au même fichier exécutable. Par exemple, vous pouvez passer un nom de fichier exécutable en tant que processName paramètre, afin d’arrêter toutes les instances en cours d’exécution de ce fichier exécutable.

Bien qu’un processus Id soit unique à une ressource de processus unique sur le système, plusieurs processus sur l’ordinateur local peuvent exécuter l’application spécifiée par le processName paramètre . Par conséquent, GetProcessById retourne un processus au maximum, mais GetProcessesByName retourne un tableau contenant tous les processus associés. Si vous devez manipuler le processus à l’aide d’appels d’API standard, vous pouvez interroger chacun de ces processus à son tour pour obtenir son identificateur. Vous ne pouvez pas accéder aux ressources de processus par le seul nom du processus, mais une fois que vous avez récupéré un tableau de Process composants qui ont été associés aux ressources de processus, vous pouvez démarrer, arrêter et manipuler les ressources système.

Vous pouvez utiliser cette surcharge pour obtenir des processus sur l’ordinateur local ainsi que sur un ordinateur distant. Utilisez « . » pour spécifier l’ordinateur local. Il existe une autre surcharge qui utilise l’ordinateur local par défaut.

Vous pouvez accéder aux processus sur des ordinateurs distants uniquement pour afficher des informations, telles que des statistiques, sur les processus. Vous ne pouvez pas fermer, arrêter (à l’aide Killde ) ou démarrer des processus sur des ordinateurs distants.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetProcessesByName(String)

Source:
Process.cs
Source:
Process.cs
Source:
Process.cs

Crée un tableau de nouveaux composants Process et les associe à toutes les ressources de processus de l'ordinateur local qui partagent le nom de processus spécifié.

public static System.Diagnostics.Process[] GetProcessesByName (string? processName);
[System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static System.Diagnostics.Process[] GetProcessesByName (string? processName);
public static System.Diagnostics.Process[] GetProcessesByName (string processName);

Paramètres

processName
String

Nom convivial du processus.

Retours

Tableau de type Process représentant les ressources de processus exécutant l'application ou le fichier spécifié.

Attributs

Exceptions

L’accès à l’API du compteur de performance pour obtenir des informations sur les processus présente des problèmes. Cette exception est propre à Windows NT, Windows 2000 et Windows XP.

Exemples

L’exemple suivant récupère des informations sur le processus actuel, les processus en cours d’exécution sur l’ordinateur local, toutes les instances du Bloc-notes exécutés sur l’ordinateur local et un processus spécifique sur l’ordinateur local. Il récupère ensuite des informations pour les mêmes processus sur un ordinateur distant.

using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        void BindToRunningProcesses()
        {
            // Get the current process.
            Process currentProcess = Process.GetCurrentProcess();

            // Get all processes running on the local computer.
            Process[] localAll = Process.GetProcesses();

            // Get all instances of Notepad running on the local computer.
            // This will return an empty array if notepad isn't running.
            Process[] localByName = Process.GetProcessesByName("notepad");

            // Get a process on the local computer, using the process id.
            // This will throw an exception if there is no such process.
            Process localById = Process.GetProcessById(1234);

            // Get processes running on a remote computer. Note that this
            // and all the following calls will timeout and throw an exception
            // if "myComputer" and 169.0.0.0 do not exist on your local network.

            // Get all processes on a remote computer.
            Process[] remoteAll = Process.GetProcesses("myComputer");

            // Get all instances of Notepad running on the specific computer, using machine name.
            Process[] remoteByName = Process.GetProcessesByName("notepad", "myComputer");

            // Get all instances of Notepad running on the specific computer, using IP address.
            Process[] ipByName = Process.GetProcessesByName("notepad", "169.0.0.0");

            // Get a process on a remote computer, using the process id and machine name.
            Process remoteById = Process.GetProcessById(2345, "myComputer");
        }

        static void Main()
        {
            MyProcess myProcess = new MyProcess();
            myProcess.BindToRunningProcesses();
        }
    }
}

Remarques

Utilisez cette méthode pour créer un tableau de nouveaux Process composants et les associer à toutes les ressources de processus qui exécutent le même fichier exécutable sur l’ordinateur local. Les ressources de processus doivent déjà exister sur l’ordinateur, car GetProcessesByName ne crée pas de ressources système, mais les associe plutôt à des composants générés par l’application Process . Un processName peut être spécifié pour un fichier exécutable qui n’est pas en cours d’exécution sur l’ordinateur local, de sorte que le tableau retourné par la méthode peut être vide.

Le nom du processus est un nom convivial pour le processus, tel qu’Outlook, qui n’inclut pas l’extension .exe ou le chemin d’accès. GetProcessesByName est utile pour obtenir et manipuler tous les processus associés au même fichier exécutable. Par exemple, vous pouvez passer un nom de fichier exécutable en tant que processName paramètre, afin d’arrêter toutes les instances en cours d’exécution de ce fichier exécutable.

Bien qu’un processus Id soit unique à une ressource de processus unique sur le système, plusieurs processus sur l’ordinateur local peuvent exécuter l’application spécifiée par le processName paramètre . Par conséquent, GetProcessById retourne un processus au maximum, mais GetProcessesByName retourne un tableau contenant tous les processus associés. Si vous devez manipuler le processus à l’aide d’appels d’API standard, vous pouvez interroger chacun de ces processus à son tour pour obtenir son identificateur. Vous ne pouvez pas accéder aux ressources de processus par le seul nom du processus, mais une fois que vous avez récupéré un tableau de Process composants qui ont été associés aux ressources de processus, vous pouvez démarrer, arrêter et manipuler les ressources système.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1