Process.GetProcessesByName Método

  • Referência

Definição

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.Process.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Cria uma matriz de novos componentes de Process e os associa aos recursos de processo existentes que compartilham o nome do processo especificado.

Sobrecargas

GetProcessesByName(String, String)

Cria uma matriz de novos componentes de Process e os associa a todos os recursos de processo em um computador remoto que compartilham o nome do processo especificado.
GetProcessesByName(String)

Cria uma matriz de novos componentes de Process e os associa a todos os recursos de processo no computador local que compartilham o nome do processo especificado.

GetProcessesByName(String, String)

Origem:
Process.Linux.cs
Origem:
Process.Linux.cs
Origem:
Process.Linux.cs

Cria uma matriz de novos componentes de Process e os associa a todos os recursos de processo em um computador remoto que compartilham o nome do processo especificado.

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

Parâmetros

processName
String

O nome amigável do processo.

machineName
String

O nome de um computador na rede.

Retornos

Process[]

Uma matriz do tipo Process que representa os recursos de processo que executam o aplicativo ou arquivo especificado.

Atributos
SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

ArgumentException

A sintaxe do parâmetro machineName é inválida. Pode ter comprimento zero (0).

ArgumentNullException

O parâmetro machineName é null.

PlatformNotSupportedException

A plataforma do sistema operacional não dá suporte a essa operação em computadores remotos.

InvalidOperationException

Falha na tentativa de se conectar ao machineName.

-ou-

Há problemas ao acessar as APIs do contador de desempenho usadas para obter informações do processo. Essa exceção é específica para Windows NT, Windows 2000 e Windows XP.

Win32Exception

Ocorreu um problema ao acessar uma API do sistema subjacente.

Exemplos

O exemplo a seguir recupera informações do processo atual, processos em execução no computador local, todas as instâncias do Bloco de Notas em execução no computador local e um processo específico no computador local. Em seguida, ele recupera informações para os mesmos processos em um computador remoto.

#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();
        }
    }
}

open System.Diagnostics

// Get the current process.
let currentProcess = Process.GetCurrentProcess()

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

// Get all instances of Notepad running on the local computer.
// This will return an empty array if notepad isn't running.
let 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.
let 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.
let remoteAll = Process.GetProcesses "myComputer"

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

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

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

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

Comentários

Use esse método para criar uma matriz de novos componentes Process e associá-los a todos os recursos de processo que estão executando o mesmo arquivo executável no computador especificado. Os recursos do processo já devem existir no computador, pois GetProcessesByName não cria recursos do sistema, mas os associa a componentes Process gerados pelo aplicativo. Um processName pode ser especificado para um arquivo executável que não está em execução no computador local, portanto, a matriz retornada pelo método pode estar vazia.

O nome do processo é um nome amigável para o processo, como o Outlook, que não inclui a extensão .exe ou o caminho. GetProcessesByName é útil para obter e manipular todos os processos associados ao mesmo arquivo executável. Por exemplo, você pode passar um nome de arquivo executável como o parâmetro processName, a fim de desligar todas as instâncias em execução desse arquivo executável.

Embora um processo Id seja exclusivo para um único recurso de processo no sistema, vários processos no computador local podem estar executando o aplicativo especificado pelo parâmetro processName. Portanto, GetProcessById retorna no máximo um processo, mas GetProcessesByName retorna uma matriz que contém todos os processos associados. Se você precisar manipular o processo usando chamadas à API padrão, poderá consultar cada um desses processos em busca de seu identificador. Você não pode acessar recursos do processo apenas por meio do nome do processo, mas, depois de recuperar uma matriz de componentes Process associados aos recursos do processo, você pode iniciar, terminar e manipular os recursos do sistema.

Você pode usar essa sobrecarga para obter processos no computador local, bem como em um computador remoto. Use "." para especificar o computador local. Existe outra sobrecarga que usa o computador local por padrão.

Você pode acessar processos em computadores remotos apenas para exibir informações, como estatísticas, sobre os processos. Você não pode fechar, terminar (usando Kill) ou iniciar processos em computadores remotos.

Confira também

Aplica-se a

GetProcessesByName(String)

Origem:
Process.cs
Origem:
Process.cs
Origem:
Process.cs

Cria uma matriz de novos componentes de Process e os associa a todos os recursos de processo no computador local que compartilham o nome do processo especificado.

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

Parâmetros

processName
String

O nome amigável do processo.

Retornos

Process[]

Uma matriz do tipo Process que representa os recursos de processo que executam o aplicativo ou arquivo especificado.

Atributos
SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Exceções

InvalidOperationException

Há problemas ao acessar as APIs do contador de desempenho usadas para obter informações do processo. Essa exceção é específica para Windows NT, Windows 2000 e Windows XP.

Exemplos

O exemplo a seguir recupera informações do processo atual, processos em execução no computador local, todas as instâncias do Bloco de Notas em execução no computador local e um processo específico no computador local. Em seguida, ele recupera informações para os mesmos processos em um computador remoto.

#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();
        }
    }
}

open System.Diagnostics

// Get the current process.
let currentProcess = Process.GetCurrentProcess()

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

// Get all instances of Notepad running on the local computer.
// This will return an empty array if notepad isn't running.
let 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.
let 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.
let remoteAll = Process.GetProcesses "myComputer"

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

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

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

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

Comentários

Use esse método para criar uma matriz de novos componentes de Process e associá-los a todos os recursos de processo que estão executando o mesmo arquivo executável no computador local. Os recursos do processo já devem existir no computador, pois GetProcessesByName não cria recursos do sistema, mas os associa a componentes Process gerados pelo aplicativo. Um processName pode ser especificado para um arquivo executável que não está em execução no computador local, portanto, a matriz retornada pelo método pode estar vazia.

O nome do processo é um nome amigável para o processo, como o Outlook, que não inclui a extensão .exe ou o caminho. GetProcessesByName é útil para obter e manipular todos os processos associados ao mesmo arquivo executável. Por exemplo, você pode passar um nome de arquivo executável como o parâmetro processName, a fim de desligar todas as instâncias em execução desse arquivo executável.

Embora um processo Id seja exclusivo para um único recurso de processo no sistema, vários processos no computador local podem estar executando o aplicativo especificado pelo parâmetro processName. Portanto, GetProcessById retorna no máximo um processo, mas GetProcessesByName retorna uma matriz que contém todos os processos associados. Se você precisar manipular o processo usando chamadas à API padrão, poderá consultar cada um desses processos em busca de seu identificador. Você não pode acessar recursos do processo apenas por meio do nome do processo, mas, depois de recuperar uma matriz de componentes Process associados aos recursos do processo, você pode iniciar, terminar e manipular os recursos do sistema.

Confira também

Aplica-se a