Freigeben über


Process.GetProcessById Methode

Definition

Erstellt eine neue Process-Komponente und ordnet diese der angegebenen vorhandenen Prozessressource zu.

Überlädt

GetProcessById(Int32)

Gibt eine neue Process-Komponente zurück, wenn der Bezeichner eines Prozesses auf dem lokalen Computer angegeben ist.

GetProcessById(Int32, String)

Gibt eine neue Process-Komponente zurück, wenn die Prozess-ID und der Name des Computers im Netzwerk angegeben sind.

GetProcessById(Int32)

Quelle:
Process.cs
Quelle:
Process.cs
Quelle:
Process.cs

Gibt eine neue Process-Komponente zurück, wenn der Bezeichner eines Prozesses auf dem lokalen Computer angegeben ist.

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

Parameter

processId
Int32

Der systemweit eindeutige Bezeichner einer Prozessressource.

Gibt zurück

Eine Process-Komponente, die der durch den processId-Parameter bezeichneten lokalen Prozessressource zugeordnet ist.

Ausnahmen

Der durch den processId-Parameter angegebene Prozess wird nicht ausgeführt. Möglicherweise ist der Bezeichner abgelaufen.

Beispiele

Im folgenden Beispiel werden Informationen zum aktuellen Prozess, prozesse, die auf dem lokalen Computer ausgeführt werden, alle Instanzen von Editor, die auf dem lokalen Computer ausgeführt werden, und ein bestimmter Prozess auf dem lokalen Computer abgerufen. Anschließend werden Informationen für die gleichen Prozesse auf einem Remotecomputer abgerufen.

#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

Hinweise

Verwenden Sie diese Methode, um eine neue Process Komponente zu erstellen und sie einer Prozessressource auf dem lokalen Computer zuzuordnen. Die Prozessressource muss bereits auf dem Computer vorhanden sein, da GetProcessById(Int32) keine Systemressource erstellt, sondern eine Ressource einer von der Anwendung generierten Process Komponente zugeordnet wird. Ein Prozess Id kann nur für einen Prozess abgerufen werden, der derzeit auf dem Computer ausgeführt wird. Löst nach Dem Beenden des Prozesses eine Ausnahme aus, GetProcessById(Int32) wenn Sie einen abgelaufenen Bezeichner übergeben.

Auf einem bestimmten Computer ist der Bezeichner eines Prozesses eindeutig. GetProcessById(Int32) gibt höchstens einen Prozess zurück. Wenn Sie alle Prozesse abrufen möchten, die eine bestimmte Anwendung ausführen, verwenden Sie GetProcessesByName(String). Wenn auf dem Computer, auf dem die angegebene Anwendung ausgeführt wird, mehrere Prozesse vorhanden sind, wird ein Array zurückgegeben, GetProcessesByName(String) das alle zugeordneten Prozesse enthält. Sie können jeden dieser Prozesse wiederum nach seinem Bezeichner abfragen. Der Prozessbezeichner kann im Processes Bereich des Windows-Task-Managers angezeigt werden. In PID der Spalte wird der Prozessbezeichner angezeigt, der einem Prozess zugewiesen ist.

Der processId Parameter ist eine Int32 (32-Bit-Ganzzahl mit Vorzeichen), obwohl die zugrunde liegende Windows-API eine DWORD (eine ganze Zahl ohne Vorzeichen) für ähnliche APIs verwendet. Dies hat historische Gründe.

Weitere Informationen

Gilt für:

GetProcessById(Int32, String)

Quelle:
Process.cs
Quelle:
Process.cs
Quelle:
Process.cs

Gibt eine neue Process-Komponente zurück, wenn die Prozess-ID und der Name des Computers im Netzwerk angegeben sind.

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

Parameter

processId
Int32

Der systemweit eindeutige Bezeichner einer Prozessressource.

machineName
String

Der Name eines Computers im Netzwerk.

Gibt zurück

Eine Process-Komponente, die der durch den processId-Parameter bezeichneten Remoteprozessressource zugeordnet ist.

Ausnahmen

Der durch den processId-Parameter angegebene Prozess wird nicht ausgeführt. Möglicherweise ist der Bezeichner abgelaufen.

- oder -

Die Syntax des machineName-Parameters ist ungültig. Der Name kann die Länge 0 (null) haben.

Der machineName-Parameter ist null.

Beispiele

Im folgenden Beispiel werden Informationen zum aktuellen Prozess, prozesse, die auf dem lokalen Computer ausgeführt werden, alle Instanzen von Editor, die auf dem lokalen Computer ausgeführt werden, und ein bestimmter Prozess auf dem lokalen Computer abgerufen. Anschließend werden Informationen für die gleichen Prozesse auf einem Remotecomputer abgerufen.

#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

Hinweise

Verwenden Sie diese Methode, um eine neue Process Komponente zu erstellen und sie einer Prozessressource auf einem Remotecomputer im Netzwerk zuzuordnen. Die Prozessressource muss bereits auf dem angegebenen Computer vorhanden sein, da GetProcessById(Int32, String) keine Systemressource erstellt, sondern eine Ressource einer von der Anwendung generierten Process Komponente zugeordnet wird. Ein Prozess Id kann nur für einen Prozess abgerufen werden, der derzeit auf dem Computer ausgeführt wird. Löst nach Dem Beenden des Prozesses eine Ausnahme aus, GetProcessById(Int32, String) wenn Sie einen abgelaufenen Bezeichner übergeben.

Auf einem bestimmten Computer ist der Bezeichner eines Prozesses eindeutig. GetProcessById(Int32, String) gibt höchstens einen Prozess zurück. Wenn Sie alle Prozesse abrufen möchten, die eine bestimmte Anwendung ausführen, verwenden Sie GetProcessesByName(String). Wenn auf dem Computer, auf dem die angegebene Anwendung ausgeführt wird, mehrere Prozesse vorhanden sind, wird ein Array zurückgegeben, GetProcessesByName(String) das alle zugeordneten Prozesse enthält. Sie können jeden dieser Prozesse wiederum nach seinem Bezeichner abfragen. Der Prozessbezeichner kann im Processes Bereich des Windows-Task-Managers angezeigt werden. In PID der Spalte wird der Prozessbezeichner angezeigt, der einem Prozess zugewiesen ist.

Wenn Sie keinen angeben machineName, wird der lokale Computer verwendet. Alternativ können Sie den lokalen Computer angeben, indem Sie auf den Wert "." oder auf eine leere Zeichenfolge ("") festlegen machineName .

Der processId Parameter ist eine Int32 (32-Bit-Ganzzahl mit Vorzeichen), obwohl die zugrunde liegende Windows-API eine DWORD (eine ganze Zahl ohne Vorzeichen) für ähnliche APIs verwendet. Dies hat historische Gründe.

Weitere Informationen

Gilt für: