Process.GetProcessesByName Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é.
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é. |
- 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 cli::array <System::Diagnostics::Process ^> ^ GetProcessesByName(System::String ^ processName, System::String ^ machineName);
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);
static member GetProcessesByName : string * string -> System.Diagnostics.Process[]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member GetProcessesByName : string * string -> System.Diagnostics.Process[]
Public Shared Function GetProcessesByName (processName As String, machineName As String) As Process()
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.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;
int main()
{
// Get the current process.
Process^ currentProcess = Process::GetCurrentProcess();
// Get all processes running on the local computer.
array<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.
array<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.
array<Process^>^remoteAll = Process::GetProcesses("myComputer");
// Get all instances of Notepad running on the specific computer, using machine name.
array<Process^>^remoteByName = Process::GetProcessesByName( "notepad", "myComputer" );
// Get all instances of Notepad running on the specific computer, using IP address.
array<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" );
}
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();
}
}
}
Imports System.Diagnostics
Imports System.ComponentModel
Namespace MyProcessSample
Class MyProcess
Sub BindToRunningProcesses()
' Get the current process. You can use currentProcess from this point
' to access various properties and call methods to control the process.
Dim currentProcess As Process = Process.GetCurrentProcess()
' Get all processes running on the local computer.
Dim localAll As Process() = Process.GetProcesses()
' Get all instances of Notepad running on the local computer.
' This will return an empty array if notepad isn't running.
Dim localByName As Process() = 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.
Dim localById As Process = 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.
Dim remoteAll As Process() = Process.GetProcesses("myComputer")
' Get all instances of Notepad running on the specific computer, using machine name.
Dim remoteByName As Process() = Process.GetProcessesByName("notepad", "myComputer")
' Get all instances of Notepad running on the specific computer, using IP address.
Dim ipByName As Process() = Process.GetProcessesByName("notepad", "169.0.0.0")
' Get a process on a remote computer, using the process id and machine name.
Dim remoteById As Process = Process.GetProcessById(2345, "myComputer")
End Sub
Shared Sub Main()
Dim myProcess As New MyProcess()
myProcess.BindToRunningProcesses()
End Sub
End Class
End Namespace 'MyProcessSample
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 |
- 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 cli::array <System::Diagnostics::Process ^> ^ GetProcessesByName(System::String ^ processName);
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);
static member GetProcessesByName : string -> System.Diagnostics.Process[]
[<System.Runtime.Versioning.SupportedOSPlatform("maccatalyst")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member GetProcessesByName : string -> System.Diagnostics.Process[]
Public Shared Function GetProcessesByName (processName As String) As Process()
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.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;
int main()
{
// Get the current process.
Process^ currentProcess = Process::GetCurrentProcess();
// Get all processes running on the local computer.
array<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.
array<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.
array<Process^>^remoteAll = Process::GetProcesses("myComputer");
// Get all instances of Notepad running on the specific computer, using machine name.
array<Process^>^remoteByName = Process::GetProcessesByName( "notepad", "myComputer" );
// Get all instances of Notepad running on the specific computer, using IP address.
array<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" );
}
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();
}
}
}
Imports System.Diagnostics
Imports System.ComponentModel
Namespace MyProcessSample
Class MyProcess
Sub BindToRunningProcesses()
' Get the current process. You can use currentProcess from this point
' to access various properties and call methods to control the process.
Dim currentProcess As Process = Process.GetCurrentProcess()
' Get all processes running on the local computer.
Dim localAll As Process() = Process.GetProcesses()
' Get all instances of Notepad running on the local computer.
' This will return an empty array if notepad isn't running.
Dim localByName As Process() = 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.
Dim localById As Process = 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.
Dim remoteAll As Process() = Process.GetProcesses("myComputer")
' Get all instances of Notepad running on the specific computer, using machine name.
Dim remoteByName As Process() = Process.GetProcessesByName("notepad", "myComputer")
' Get all instances of Notepad running on the specific computer, using IP address.
Dim ipByName As Process() = Process.GetProcessesByName("notepad", "169.0.0.0")
' Get a process on a remote computer, using the process id and machine name.
Dim remoteById As Process = Process.GetProcessById(2345, "myComputer")
End Sub
Shared Sub Main()
Dim myProcess As New MyProcess()
myProcess.BindToRunningProcesses()
End Sub
End Class
End Namespace 'MyProcessSample
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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :