Process.GetProcessesByName Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Vytvoří pole nových Process komponent a přidruží je k existujícím prostředkům procesu, které všechny sdílejí zadaný název procesu.

Přetížení

GetProcessesByName(String, String)	Vytvoří pole nových Process komponent a přidruží je ke všem prostředkům procesu na vzdáleném počítači, který sdílí zadaný název procesu.
GetProcessesByName(String)	Vytvoří pole nových Process komponent a přidruží je ke všem prostředkům procesu v místním počítači, které sdílejí zadaný název procesu.

GetProcessesByName(String, String)

Zdroj:

Process.Linux.cs

Vytvoří pole nových Process komponent a přidruží je ke všem prostředkům procesu na vzdáleném počítači, který sdílí zadaný název procesu.

public:
 static cli::array <System::Diagnostics::Process ^> ^ GetProcessesByName(System::String ^ processName, System::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);

[<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()

Parametry

processName

String

Popisný název procesu.

machineName

String

Název počítače v síti.

Návraty

Process[]

Pole typu Process , které představuje prostředky procesu, na kterých běží zadaná aplikace nebo soubor.

Atributy

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Výjimky

ArgumentException

Syntaxe machineName parametru je neplatná. Může mít délku nula (0).

ArgumentNullException

Parametr machineName je null.

PlatformNotSupportedException

Platforma operačního systému tuto operaci na vzdálených počítačích nepodporuje.

InvalidOperationException

Pokus o připojení se nezdařil machineName .

-nebo-

Při přístupu k rozhraním API čítačů výkonu používaných k získání informací o procesu dochází k problémům. Tato výjimka je specifická pro systém Windows NT, Windows 2000 a Windows XP.

Win32Exception

Při přístupu k podkladovému systémovému rozhraní API došlo k problému.

Příklady

Následující příklad načte informace o aktuálním procesu, procesech spuštěných v místním počítači, všech instancích Poznámkového bloku spuštěných v místním počítači a konkrétního procesu v místním počítači. Potom na vzdáleném počítači načte informace o stejných procesech.

#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

Poznámky

Pomocí této metody můžete vytvořit pole nových Process součástí a přidružit je ke všem prostředkům procesu, na kterých běží stejný spustitelný soubor v zadaném počítači. Prostředky procesu již musí existovat v počítači, protože GetProcessesByName nevytáčí systémové prostředky, ale spíše je přidruží k komponentám vygenerovaným Process aplikacím. Pro processName spustitelný soubor, který momentálně není spuštěný v místním počítači, lze zadat A, takže pole, které metoda vrátí, může být prázdné.

Název procesu je popisný název procesu, například Outlook, který neobsahuje rozšíření .exe ani cestu. GetProcessesByName je užitečný pro získání a manipulaci se všemi procesy, které jsou přidruženy ke stejnému spustitelnému souboru. Jako parametr můžete například předat název processName spustitelného souboru, abyste vypnuli všechny spuštěné instance tohoto spustitelného souboru.

I když je proces Id jedinečný pro jeden prostředek procesu v systému, více procesů v místním počítači může být spuštěna aplikace určená parametrem processName . GetProcessById Proto vrátí maximálně jeden proces, ale GetProcessesByName vrátí pole obsahující všechny přidružené procesy. Pokud potřebujete manipulovat s procesem pomocí standardních volání rozhraní API, můžete se dotazovat na identifikátor každého z těchto procesů. K prostředkům procesu nelze získat přístup prostřednictvím samotného názvu procesu, ale jakmile načtete pole Process komponent, které byly přidruženy k prostředkům procesu, můžete spustit, ukončit a jinak manipulovat se systémovými prostředky.

Toto přetížení můžete použít k získání procesů v místním i vzdáleném počítači. Použijte "." k určení místního počítače. Existuje další přetížení, které ve výchozím nastavení používá místní počítač.

K procesům ve vzdálených počítačích můžete přistupovat pouze za účelem zobrazení informací o procesech, jako jsou statistiky. Nelze zavřít, ukončit (pomocí Kill) nebo spustit procesy ve vzdálených počítačích.

Viz také

• ProcessName
• MachineName
• GetProcessById(Int32, String)
• GetProcesses()
• GetCurrentProcess()

GetProcessesByName(String)

Zdroj:

Process.cs

Vytvoří pole nových Process komponent a přidruží je ke všem prostředkům procesu v místním počítači, které sdílejí zadaný název procesu.

public:
 static cli::array <System::Diagnostics::Process ^> ^ GetProcessesByName(System::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);

[<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()

Parametry

processName

String

Popisný název procesu.

Návraty

Process[]

Pole typu Process , které představuje prostředky procesu, na kterých běží zadaná aplikace nebo soubor.

Atributy

SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Výjimky

InvalidOperationException

Při přístupu k rozhraním API čítačů výkonu používaných k získání informací o procesu dochází k problémům. Tato výjimka je specifická pro systém Windows NT, Windows 2000 a Windows XP.

Příklady

Následující příklad načte informace o aktuálním procesu, procesech spuštěných v místním počítači, všech instancích Poznámkového bloku spuštěných v místním počítači a konkrétního procesu v místním počítači. Potom na vzdáleném počítači načte informace o stejných procesech.

#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

Poznámky

Pomocí této metody můžete vytvořit pole nových Process komponent a přidružit je ke všem prostředkům procesu, na kterých běží stejný spustitelný soubor v místním počítači. Prostředky procesu již musí existovat v počítači, protože GetProcessesByName nevytáčí systémové prostředky, ale spíše je přidruží k komponentám vygenerovaným Process aplikacím. Pro processName spustitelný soubor, který momentálně není spuštěný v místním počítači, lze zadat A, takže pole, které metoda vrátí, může být prázdné.

Název procesu je popisný název procesu, například Outlook, který neobsahuje rozšíření .exe ani cestu. GetProcessesByName je užitečný pro získání a manipulaci se všemi procesy, které jsou přidruženy ke stejnému spustitelnému souboru. Jako parametr můžete například předat název processName spustitelného souboru, abyste vypnuli všechny spuštěné instance tohoto spustitelného souboru.

I když je proces Id jedinečný pro jeden prostředek procesu v systému, více procesů v místním počítači může být spuštěna aplikace určená parametrem processName . GetProcessById Proto vrátí maximálně jeden proces, ale GetProcessesByName vrátí pole obsahující všechny přidružené procesy. Pokud potřebujete manipulovat s procesem pomocí standardních volání rozhraní API, můžete se dotazovat na identifikátor každého z těchto procesů. K prostředkům procesu nelze získat přístup prostřednictvím samotného názvu procesu, ale jakmile načtete pole Process komponent, které byly přidruženy k prostředkům procesu, můžete spustit, ukončit a jinak manipulovat se systémovými prostředky.

Viz také

• ProcessName
• GetProcessById(Int32, String)
• GetProcesses()
• GetCurrentProcess()