Aracılığıyla paylaş

Process.GetProcessesByName Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Diagnostics
Bütünleştirilmiş Kod:
System.Diagnostics.Process.dll
Bütünleştirilmiş Kod:
System.dll
Bütünleştirilmiş Kod:
netstandard.dll

Yeni Process bileşenlerinden oluşan bir dizi oluşturur ve bunları belirtilen işlem adını paylaşan mevcut işlem kaynaklarıyla ilişkilendirir.

Aşırı Yüklemeler

GetProcessesByName(String, String)

Yeni Process bileşenlerinden oluşan bir dizi oluşturur ve bunları belirtilen işlem adını paylaşan uzak bir bilgisayardaki tüm işlem kaynaklarıyla ilişkilendirir.
GetProcessesByName(String)

Yeni Process bileşenlerinden oluşan bir dizi oluşturur ve bunları belirtilen işlem adını paylaşan yerel bilgisayardaki tüm işlem kaynaklarıyla ilişkilendirir.

GetProcessesByName(String, String)

Kaynak:
Process.Linux.cs
Kaynak:
Process.Linux.cs
Kaynak:
Process.Linux.cs

Yeni Process bileşenlerinden oluşan bir dizi oluşturur ve bunları belirtilen işlem adını paylaşan uzak bir bilgisayardaki tüm işlem kaynaklarıyla ilişkilendirir.

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

Parametreler

processName
String

İşlemin kolay adı.

machineName
String

Ağdaki bir bilgisayarın adı.

Döndürülenler

Process[]

Belirtilen uygulama veya dosyayı çalıştıran işlem kaynaklarını temsil eden Process türünde bir dizi.

Öznitelikler
SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

ArgumentException

machineName parametre söz dizimi geçersiz. Uzunluğu sıfır (0) olabilir.

ArgumentNullException

machineName parametresi null.

PlatformNotSupportedException

İşletim sistemi platformu uzak bilgisayarlarda bu işlemi desteklemez.

InvalidOperationException

machineName bağlanma girişimi başarısız oldu.

-veya-

İşlem bilgilerini almak için kullanılan performans sayacı API'lerine erişirken sorun yaşanıyor. Bu özel durum Windows NT, Windows 2000 ve Windows XP'ye özgüdür.

Win32Exception

Temel alınan sistem API'lerine erişilirken bir sorun oluştu.

Örnekler

Aşağıdaki örnek geçerli işlemin, yerel bilgisayarda çalışan işlemlerin, yerel bilgisayarda çalışan tüm Not Defteri örneklerinin ve yerel bilgisayardaki belirli bir işlemin bilgilerini alır. Ardından uzak bir bilgisayarda aynı işlemlere ilişkin bilgileri alır.

#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

Açıklamalar

Yeni Process bileşenlerinden oluşan bir dizi oluşturmak ve bunları belirtilen bilgisayarda aynı yürütülebilir dosyayı çalıştıran tüm işlem kaynaklarıyla ilişkilendirmek için bu yöntemi kullanın. GetProcessesByName sistem kaynakları oluşturmadığından ancak bunları uygulama tarafından oluşturulan Process bileşenleriyle ilişkilendirdiğinden işlem kaynaklarının bilgisayarda zaten mevcut olması gerekir. Şu anda yerel bilgisayarda çalışmayan yürütülebilir bir dosya için bir processName belirtilebilir, bu nedenle yöntemin döndürdüğü dizi boş olabilir.

İşlem adı, outlook gibi işlem için .exe uzantısını veya yolu içermeyen kolay bir addır. GetProcessesByName, aynı yürütülebilir dosyayla ilişkili tüm işlemleri almak ve işlemek için yararlıdır. Örneğin, yürütülebilir dosyanın çalışan tüm örneklerini kapatmak için yürütülebilir dosya adını processName parametresi olarak geçirebilirsiniz.

İşlem Id sistemdeki tek bir işlem kaynağına özgü olsa da, yerel bilgisayardaki birden çok işlem processName parametresi tarafından belirtilen uygulamayı çalıştırabilir. Bu nedenle, GetProcessById en fazla bir işlem döndürür, ancak GetProcessesByName tüm ilişkili işlemleri içeren bir dizi döndürür. Standart API çağrılarını kullanarak işlemi işlemeniz gerekiyorsa, bu işlemlerin her birini sırayla tanımlayıcısı için sorgulayabilirsiniz. İşlem kaynaklarına yalnızca işlem adı üzerinden erişemezsiniz, ancak işlem kaynaklarıyla ilişkilendirilmiş bir Process bileşeni dizisi aldıktan sonra sistem kaynaklarını başlatabilir, sonlandırabilir ve başka şekilde işleyebilirsiniz.

İşlemleri hem yerel bilgisayarda hem de uzak bir bilgisayarda almak için bu aşırı yüklemeyi kullanabilirsiniz. Yerel bilgisayarı belirtmek için "." kullanın. Varsayılan olarak yerel bilgisayarı kullanan başka bir aşırı yükleme vardır.

Uzak bilgisayarlardaki işlemlere yalnızca istatistikler gibi işlemler hakkındaki bilgileri görüntülemek için erişebilirsiniz. Uzak bilgisayarlarda işlemleri kapatamaz, sonlandıramaz (Killkullanarak) veya başlatamazsınız.

Ayrıca bkz.

Şunlara uygulanır

GetProcessesByName(String)

Kaynak:
Process.cs
Kaynak:
Process.cs
Kaynak:
Process.cs

Yeni Process bileşenlerinden oluşan bir dizi oluşturur ve bunları belirtilen işlem adını paylaşan yerel bilgisayardaki tüm işlem kaynaklarıyla ilişkilendirir.

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

Parametreler

processName
String

İşlemin kolay adı.

Döndürülenler

Process[]

Belirtilen uygulama veya dosyayı çalıştıran işlem kaynaklarını temsil eden Process türünde bir dizi.

Öznitelikler
SupportedOSPlatformAttribute UnsupportedOSPlatformAttribute

Özel durumlar

InvalidOperationException

İşlem bilgilerini almak için kullanılan performans sayacı API'lerine erişirken sorun yaşanıyor. Bu özel durum Windows NT, Windows 2000 ve Windows XP'ye özgüdür.

Örnekler

Aşağıdaki örnek geçerli işlemin, yerel bilgisayarda çalışan işlemlerin, yerel bilgisayarda çalışan tüm Not Defteri örneklerinin ve yerel bilgisayardaki belirli bir işlemin bilgilerini alır. Ardından uzak bir bilgisayarda aynı işlemlere ilişkin bilgileri alır.

#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

Açıklamalar

Yeni Process bileşenlerinden oluşan bir dizi oluşturmak ve bunları yerel bilgisayarda aynı yürütülebilir dosyayı çalıştıran tüm işlem kaynaklarıyla ilişkilendirmek için bu yöntemi kullanın. GetProcessesByName sistem kaynakları oluşturmadığından ancak bunları uygulama tarafından oluşturulan Process bileşenleriyle ilişkilendirdiğinden işlem kaynaklarının bilgisayarda zaten mevcut olması gerekir. Şu anda yerel bilgisayarda çalışmayan yürütülebilir bir dosya için bir processName belirtilebilir, bu nedenle yöntemin döndürdüğü dizi boş olabilir.

İşlem adı, outlook gibi işlem için .exe uzantısını veya yolu içermeyen kolay bir addır. GetProcessesByName, aynı yürütülebilir dosyayla ilişkili tüm işlemleri almak ve işlemek için yararlıdır. Örneğin, yürütülebilir dosyanın çalışan tüm örneklerini kapatmak için yürütülebilir dosya adını processName parametresi olarak geçirebilirsiniz.

İşlem Id sistemdeki tek bir işlem kaynağına özgü olsa da, yerel bilgisayardaki birden çok işlem processName parametresi tarafından belirtilen uygulamayı çalıştırabilir. Bu nedenle, GetProcessById en fazla bir işlem döndürür, ancak GetProcessesByName tüm ilişkili işlemleri içeren bir dizi döndürür. Standart API çağrılarını kullanarak işlemi işlemeniz gerekiyorsa, bu işlemlerin her birini sırayla tanımlayıcısı için sorgulayabilirsiniz. İşlem kaynaklarına yalnızca işlem adı üzerinden erişemezsiniz, ancak işlem kaynaklarıyla ilişkilendirilmiş bir Process bileşeni dizisi aldıktan sonra sistem kaynaklarını başlatabilir, sonlandırabilir ve başka şekilde işleyebilirsiniz.

Ayrıca bkz.

Şunlara uygulanır