Process.GetProcessesByName Metod

Definition

Namnområde:: System.Diagnostics

Sammansättningar:: netstandard.dll, System.Diagnostics.Process.dll

Sammansättning:: System.Diagnostics.Process.dll

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en matris med nya Process komponenter och associerar dem med befintliga processresurser som alla delar det angivna processnamnet.

Överlagringar

Name	Description
GetProcessesByName(String)	Skapar en matris med nya Process komponenter och associerar dem med alla processresurser på den lokala datorn som delar det angivna processnamnet.
GetProcessesByName(String, String)	Skapar en matris med nya Process komponenter och associerar dem med alla processresurser på en fjärrdator som delar det angivna processnamnet.

GetProcessesByName(String)

Källa:: Process.cs

Källa:: Process.cs

Källa:: Process.cs

Källa:: Process.cs

Källa:: Process.cs

Skapar en matris med nya Process komponenter och associerar dem med alla processresurser på den lokala datorn som delar det angivna processnamnet.

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

public static System.Diagnostics.Process[] GetProcessesByName(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")>]
static member GetProcessesByName : string -> System.Diagnostics.Process[]

static member GetProcessesByName : string -> System.Diagnostics.Process[]

Public Shared Function GetProcessesByName (processName As String) As Process()

Parametrar

processName: String

Det egna namnet på processen.

Returer

Process[]

En matris av typen Process som representerar processresurserna som kör det angivna programmet eller filen.

Attribut: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Undantag

InvalidOperationException

Det finns problem med att komma åt prestandaräknarens API:er som används för att hämta processinformation. Det här undantaget är specifikt för Windows NT, Windows 2000 och Windows XP.

Exempel

I följande exempel hämtas information om den aktuella processen, processer som körs på den lokala datorn, alla instanser av Anteckningar som körs på den lokala datorn och en specifik process på den lokala datorn. Den hämtar sedan information för samma processer på en fjärrdator.

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

Kommentarer

Använd den här metoden för att skapa en matris med nya Process komponenter och associera dem med alla processresurser som kör samma körbara fil på den lokala datorn. Processresurserna måste redan finnas på datorn, eftersom GetProcessesByName de inte skapar systemresurser utan associerar dem med programgenererade Process komponenter. A processName kan anges för en körbar fil som för närvarande inte körs på den lokala datorn, så matrisen som metoden returnerar kan vara tom.

Processnamnet är ett eget namn för processen, till exempel Outlook, som inte innehåller .exe-tillägget eller sökvägen. GetProcessesByName är användbart för att hämta och manipulera alla processer som är associerade med samma körbara fil. Du kan till exempel skicka ett körbart filnamn som processName parameter för att stänga av alla körbara instanser av den körbara filen.

Även om en process Id är unik för en enskild processresurs i systemet kan flera processer på den lokala datorn köra programmet som anges av parametern processName . GetProcessById Returnerar därför en process som mest, men GetProcessesByName returnerar en matris som innehåller alla associerade processer. Om du behöver ändra processen med hjälp av standard-API-anrop kan du i sin tur fråga var och en av dessa processer om dess identifierare. Du kan inte komma åt processresurser enbart via processnamnet, men när du har hämtat en matris Process med komponenter som har associerats med processresurserna kan du starta, avsluta och på annat sätt manipulera systemresurserna.

Se även

Gäller för

GetProcessesByName(String, String)

Källa:: Process.Linux.cs

Källa:: Process.cs

Källa:: Process.Linux.cs

Källa:: Process.Linux.cs

Källa:: Process.Linux.cs

Skapar en matris med nya Process komponenter och associerar dem med alla processresurser på en fjärrdator som delar det angivna processnamnet.

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

public static System.Diagnostics.Process[] GetProcessesByName(string? processName, 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")>]
static member GetProcessesByName : string * string -> System.Diagnostics.Process[]

static member GetProcessesByName : string * string -> System.Diagnostics.Process[]

Public Shared Function GetProcessesByName (processName As String, machineName As String) As Process()

Parametrar

processName: String

Det egna namnet på processen.

machineName: String

Namnet på en dator i nätverket.

Returer

Process[]

En matris av typen Process som representerar processresurserna som kör det angivna programmet eller filen.

Attribut: SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Undantag

ArgumentException

Parametersyntaxen machineName är ogiltig. Det kan ha längd noll (0).

ArgumentNullException

Parametern machineName är null.

PlatformNotSupportedException

Operativsystemplattformen stöder inte den här åtgärden på fjärrdatorer.

InvalidOperationException

Det gick inte att ansluta till machineName .

-eller-

Det finns problem med att komma åt prestandaräknarens API:er som används för att hämta processinformation. Det här undantaget är specifikt för Windows NT, Windows 2000 och Windows XP.

Win32Exception

Ett problem uppstod vid åtkomst till ett underliggande system-API.

Exempel

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

Kommentarer

Använd den här metoden för att skapa en matris med nya Process komponenter och associera dem med alla processresurser som kör samma körbara fil på den angivna datorn. Processresurserna måste redan finnas på datorn, eftersom GetProcessesByName de inte skapar systemresurser utan associerar dem med programgenererade Process komponenter. A processName kan anges för en körbar fil som för närvarande inte körs på den lokala datorn, så matrisen som metoden returnerar kan vara tom.

Du kan använda den här överbelastningen för att hämta processer på den lokala datorn och på en fjärrdator. Använd "." för att ange den lokala datorn. Det finns en annan överlagring som använder den lokala datorn som standard.

Du kan bara komma åt processer på fjärrdatorer för att visa information, till exempel statistik, om processerna. Du kan inte stänga, avsluta (med hjälp av Kill) eller starta processer på fjärrdatorer.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?