Process.GetProcessById Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.Process.dll

Vytvoří novou Process komponentu a přidruží ji k existujícímu prostředku procesu, který zadáte.

Přetížení

GetProcessById(Int32)	Vrátí novou Process komponentu zadanou identifikátorem procesu v místním počítači.
GetProcessById(Int32, String)	Vrátí novou Process komponentu s identifikátorem procesu a názvem počítače v síti.

GetProcessById(Int32)

Zdroj:

Process.cs

Vrátí novou Process komponentu zadanou identifikátorem procesu v místním počítači.

public:
 static System::Diagnostics::Process ^ GetProcessById(int processId);

public static System.Diagnostics.Process GetProcessById (int processId);

static member GetProcessById : int -> System.Diagnostics.Process

Public Shared Function GetProcessById (processId As Integer) As Process

Parametry

processId

Int32

Systémově jedinečný identifikátor prostředku procesu.

Návraty

Process

Komponenta Process , která je přidružena k prostředku místního procesu identifikovaného parametrem processId .

Výjimky

ArgumentException

Proces určený parametrem processId není spuštěný. Možná vypršela platnost identifikátoru.

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 novou Process komponentu a přidružit ji k prostředku procesu v místním počítači. Prostředek procesu již musí v počítači existovat, protože GetProcessById(Int32) nevytvoří systémový prostředek, ale spíše přidruží prostředek k komponentě vygenerované Process aplikací. Proces Id lze načíst pouze pro proces, který je aktuálně spuštěn na počítači. Po ukončení procesu vyvolá výjimku, GetProcessById(Int32) pokud mu předáte identifikátor s prošlou platností.

Na jakémkoli konkrétním počítači je identifikátor procesu jedinečný. GetProcessById(Int32) vrátí maximálně jeden proces. Pokud chcete získat všechny procesy spuštěné v konkrétní aplikaci, použijte GetProcessesByName(String). Pokud na počítači se zadanou aplikací existuje více procesů, GetProcessesByName(String) vrátí pole obsahující všechny přidružené procesy. Na každý z těchto procesů se můžete následně dotazovat na jeho identifikátor. Identifikátor procesu lze zobrazit na panelu Processes Správce úloh systému Windows. Sloupec PID zobrazuje identifikátor procesu, který je přiřazen procesu.

Parametr processId je ( Int32 32bitové celé číslo se znaménkem), i když základní rozhraní API systému Windows používá DWORD pro podobná rozhraní API (32bitové celé číslo bez znaménka). To je z historických důvodů.

Viz také

• Id
• GetProcessesByName(String)
• GetProcesses()
• GetCurrentProcess()

GetProcessById(Int32, String)

Zdroj:

Process.cs

Vrátí novou Process komponentu s identifikátorem procesu a názvem počítače v síti.

public:
 static System::Diagnostics::Process ^ GetProcessById(int processId, System::String ^ machineName);

public static System.Diagnostics.Process GetProcessById (int processId, string machineName);

static member GetProcessById : int * string -> System.Diagnostics.Process

Public Shared Function GetProcessById (processId As Integer, machineName As String) As Process

Parametry

processId

Int32

Systémově jedinečný identifikátor prostředku procesu.

machineName

String

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

Návraty

Process

Komponenta Process , která je přidružena ke vzdálenému prostředku procesu identifikovanému parametrem processId .

Výjimky

ArgumentException

Proces určený parametrem processId není spuštěný. Možná vypršela platnost identifikátoru.

-nebo-

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

ArgumentNullException

Parametr machineName je null.

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 novou Process komponentu a přidružit ji k prostředku procesu ve vzdáleném počítači v síti. Prostředek procesu již musí existovat v zadaném počítači, protože GetProcessById(Int32, String) nevytvoří systémový prostředek, ale spíše přidruží prostředek k komponentě vygenerované Process aplikací. Proces Id lze načíst pouze pro proces, který je aktuálně spuštěn na počítači. Po ukončení procesu vyvolá výjimku, GetProcessById(Int32, String) pokud mu předáte identifikátor s prošlou platností.

Na jakémkoli konkrétním počítači je identifikátor procesu jedinečný. GetProcessById(Int32, String) vrátí maximálně jeden proces. Pokud chcete získat všechny procesy spuštěné v konkrétní aplikaci, použijte GetProcessesByName(String). Pokud na počítači se zadanou aplikací existuje více procesů, GetProcessesByName(String) vrátí pole obsahující všechny přidružené procesy. Na každý z těchto procesů se můžete následně dotazovat na jeho identifikátor. Identifikátor procesu lze zobrazit na panelu Processes Správce úloh systému Windows. Sloupec PID zobrazuje identifikátor procesu, který je přiřazen procesu.

Pokud nezadáte machineName, použije se místní počítač. Případně můžete zadat místní počítač nastavením machineName na hodnotu "." nebo na prázdný řetězec ("").

Parametr processId je ( Int32 32bitové celé číslo se znaménkem), i když základní rozhraní API systému Windows používá DWORD pro podobná rozhraní API (32bitové celé číslo bez znaménka). To je z historických důvodů.

Viz také

• Id
• MachineName
• GetProcessesByName(String)
• GetProcesses()
• GetCurrentProcess()