CA1839: Process.GetCurrentProcess() yerine Environment.ProcessPath kullanın. MainModule.FileName

Özellik Değer
Kural Kimliği CA1839
Başlık Process.GetCurrentProcess().MainModule.FileName yerine Environment.ProcessPath kullanın.
Kategori Performans
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
.NET 10'da varsayılan olarak etkin Öneri olarak
Geçerli diller C# ve Visual Basic

Neden

yerine işlemi Process.GetCurrentProcess().MainModule.FileNamebaşlatan dosyanın yolunu almak için kullanınEnvironment.ProcessPath.

Kural açıklaması

System.Diagnostics.Process.GetCurrentProcess().MainModule.FileName pahalıdır:

  • Genellikle yalnızca FileName almak için bir Process ve ProcessModule örneği ayırır.
  • Örneğin Process bertaraf edilmesi gerekir ve bunun performans üzerinde bir etkisi vardır.
  • Process örneğinde Dispose() çağrısını yapmayı unutmak kolaydır.
  • Eğer FileName dışında hiç kimse Process örneğini kullanmıyorsa, başvurulan türlerin grafiği arttığı için bağlantılı boyut gereksiz yere büyür.
  • Bu API'yi keşfetmek veya bulmak biraz zordur.

System.Environment.ProcessPath tüm bu dezavantajları önler ve aynı bilgileri üretir.

Not

System.Environment.ProcessPath .NET 6'dan itibaren kullanılabilir.

İhlalleri düzeltme

İhlal el ile düzeltilebilir veya bazı durumlarda Visual Studio'da kodu düzeltmek için Hızlı Eylemler kullanılabilir.

Aşağıdaki iki kod parçacığı kuralın ihlalini ve nasıl düzeltileceğini gösterir:

using System.Diagnostics;

class MyClass
{
    void MyMethod()
    {
        string path = Process.GetCurrentProcess().MainModule.FileName; // Violation occurs
    }
}
Imports System.Diagnostics

Class MyClass
    Private Sub MyMethod()
        Dim path As String = Process.GetCurrentProcess().MainModule.FileName ' Violation occurs.
    End Function
End Class
using System.Diagnostics;

class MyClass
{
    void MyMethod()
    {
        string path = System.Environment.ProcessPath; // Violation fixed
    }
}
Imports System.Diagnostics

Class MyClass
    Private Sub MyMethod()
        Dim path As String = System.Environment.ProcessPath ' Violation fixed.
    End Function
End Class

İpucu

Visual Studio'da bu kural için bir kod düzeltmesi kullanılabilir. Bunu kullanmak için imleci ihlalin üzerine getirin ve Ctrl+. (nokta) tuşuna basın. Sunulan seçenekler listesinden 'Environment.ProcessPath' kullan'ı seçin.

CA1839 için kod düzeltmesi - 'Environment.ProcessPath' kullanma

Uyarıların ne zaman bastırılması gerekiyor?

Gereksiz ayırma ve Process ile ProcessModule örneklerinin nihai elden çıkarılmasından kaynaklanan performans etkisi konusunda endişeniz yoksa, bu kuralın ihlalini bastırmak güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1839
// The code that's violating the rule is on this line.
#pragma warning restore CA1839

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1839.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Ayrıca bkz.