10 Dakika veya Daha Az Sürede C# Uygulamalarında Komut Satırı Argümanları

Komut Satırı Argümanları Nedir?

Başlangıçta, Tim komut satırı argümanlarının neden önemli olduğunu açıklar. Onları, hangi görüntüyü yükleyeceğimiz veya hangi görevi gerçekleştireceğimiz gibi komutları belirttiğimiz Docker gibi araçları nasıl başlattığımıza benzetir. Benzer şekilde, C# komut satırı uygulamalarında, programın çalışma zamanındaki davranışını tanımlayan parametreler geçirebilirsiniz.

Örneğin, dosyaları işlemek için bir konsol uygulaması çalıştırıyorsanız, dosya yolunu veya modunu komut satırı girişi yoluyla belirtmek isteyebilirsiniz - kodu değiştirmek yerine.

Konsol Projesini Kurma

Tim, Visual Studio'da temel bir .NET 8 Konsol Uygulaması projesiyle başlar. Varsayılan kod sadece, "Çıkmak için geri dön tuşuna basın," gibi bir mesaj yazdırır ve kullanıcı girişi beklemek için bir Console.ReadLine() ifadesi kullanır.

Artık, komut satırı girişini yönetmek için, Tim, uygulama çalıştırıldığında geçilen argümanları depolayan args dizisini tanıtır. Modern C# konsol uygulamaları üst seviye ifadeler kullanıyor olsa da sahne arkasında bir giriş noktası şu şekilde tanımlanmıştır:

static void Main(string[] args)

static void Main(string[] args)

veya bazen şöyle:

static int Main(string[] args)

static int Main(string[] args)

Bu imzalar, yürütmenin başladığı ana yöntemi - giriş noktasını - temsil eder. Args parametresi, komut satırından sağlanan tüm argümanları içeren bir dizi karakter (string[]) dizisidir.

Tim, bir foreach döngüsünü kullanarak args dizisinde nasıl yineleneceğini gösterir.

foreach (var arg in args)
{
    Console.WriteLine(arg);
}

foreach (var arg in args)
{
    Console.WriteLine(arg);
}

Burada, var arg args dizisindeki her karakter dizisini temsil eder ve program, bunları konsol çıktısında ayrı satırlarda görüntüler.

Tim, üst düzey ifadelerin Program sınıfı ve Main yöntemi gibi otomatik oluşturulan kodu gizlese de her şeyin aynı şekilde çalıştığını — args dizisinin her zaman mevcut olduğunu ve komut satırı argümanlarını yakalamaya hazır olduğunu not eder.

Konsol Uygulamasını Çalıştırma

Sonraki adımda, Tim bu özelliği nasıl test edeceğini gösterir. Visual Studio içinde program normal şekilde çalıştırıldığında bir şey görünmeyecektir, çünkü hiçbir komut satırı girişi sağlanmamıştır.

Düzgün test etmek için, yürütme sürecini manuel olarak değiştirir: Dosya Gezgini'ni açar, projenin bin → Debug → net8.0 klasörüne gider ve o yoldan terminal penceresi başlatır.

Oradan, aşağıdaki komutu kullanır:

ConsoleArgs.exe "hello world" -t timing

ConsoleArgs.exe "hello world" -t timing

Bu komut birkaç temel noktayı gösterir:

• Tırnak içindeki "hello world" tek bir karakter dizisi argümanı olarak kabul edilir, iki ayrı kelime olarak değil.

• -t bayrağı ve zamanlama kelimesi iki ek argüman olarak kabul edilir.

Çalıştırıldığında, konsol çıktısı şunu gösterir:

hello world  
-t  
timing

hello world  
-t  
timing

Her bir satır argümanı, args dizisinde bir öğeyi temsil eder. Tim, bu durumu komut satırı argümanlarının doğru kullanımı olarak onayladığını açıklar - konsol uygulaması, yürütme sırasında iletilen tüm argümanları başarıyla aldı ve görüntüledi.

Projeye ait bir dizinden çalışırken geliştiricilerin, yürütülebilir yolu yerine dotnet run komutunu da kullanabileceğini belirtir:

dotnet run -- "hello world" -t timing

dotnet run -- "hello world" -t timing

İki tire (--) ifadesi, .NET'in, sonrasındaki her şeyi programınız için komut satırı parametreleri olarak ele almasını söyler, .NET CLI kendisi için değil.

Komut Satırı Argümanlarının İşlenmesi ve Ayrıştırılması

Şimdi argümanları okuyabildiğimize göre, Tim komut satırı argümanlarını akıllıca ele almayı tartışıyor.

Örneğin, -t bir değer bekleyen bir bayrak ise, program sonraki dize argümanını değeri olarak ele almayı bilmelidir. Tim, bunu args dizisindeki indeksleri kontrol ederek manuel olarak nasıl ayrıştırabileceğinizi gösterir:

for (int i = 0; i < args.Length; i++)
{
    if (args[i] == "-t")
    {
        var value = args[i + 1];
        Console.WriteLine($"Timing parameter: {value}");
    }
}

for (int i = 0; i < args.Length; i++)
{
    if (args[i] == "-t")
    {
        var value = args[i + 1];
        Console.WriteLine($"Timing parameter: {value}");
    }
}

Bu yaklaşım, adlandırılmış argümanları, sayısal türleri ve hatta ayrıntılı mod bayraklarını ele almayı sağlar. Tim, geliştiricilerin genellikle daha gelişmiş argüman ayrıştırması için switch ifadesi veya dış dokümanlar ve kütüphaneler kullandıklarını, ancak System ad alanı ve args dizisinin temel durumlar için gereken her şeyi zaten sağladığını ifade eder.

Bir Windows Forms Uygulamasına Genişletme

Konsol uygulamalarını gösterdikten sonra, Tim bir Windows Forms uygulamasına (WinForms) geçer.

Oluşturulan kodda, Program.cs dosyası bir static void Main() yöntemi içerir, ancak henüz parametre kabul etmiyor. Komut satırı argümanlarını etkinleştirmek için Tim, Main yöntemini args parametresini içerecek şekilde elle değiştirir:

[STAThread]
static void Main(string[] args)
{
    ApplicationConfiguration.Initialize();
    Application.Run(new Form1(args.FirstOrDefault() ?? "default"));
}

[STAThread]
static void Main(string[] args)
{
    ApplicationConfiguration.Initialize();
    Application.Run(new Form1(args.FirstOrDefault() ?? "default"));
}

args.FirstOrDefault(), args dizisinden (veya argüman sağlanmadığında "default" döndürüldüğünde) ilk girdi parametresini alır.

Sonrasında, Form1 sınıfında, Tim yapıcıyı bir dize argüman alacak şekilde günceller:

public Form1(string name)
{
    InitializeComponent();
    displayName.Text = name;
}

public Form1(string name)
{
    InitializeComponent();
    displayName.Text = name;
}

Burada, displayName, Windows Forms Tasarımcısı'nda tanımlanmış bir etikettir ve artık komut satırı aracılığıyla iletilen argümanı gösterir.

Programı argümanlar olmadan çalıştırdığında, etiket "default" görüntüler. Tekrar çalıştırdığında:

WinFormsArgs.exe "Hello World"

WinFormsArgs.exe "Hello World"

form penceresi "Hello World" gösterir.

Tim, bu tekniğin, komut satırı argümanlarını desteklemek için Windows Forms uygulamalarına, konsol uygulamaları gibi kullanıcıların başlangıç davranışını dinamik biçimde değiştirme yeteneği verdiğini açıklar.

Komut Satırı Argümanlarının Pratik Kullanımları (7:18)

Tim, bu özelliğin komut satırı araçlarının ne kadar çok yönlü olabileceğini tartışarak sözlerini tamamlar. Geliştiriciler, komut satırı argümanlarını şöyle kullanabilir:

• Uygulamaları farklı modlarda başlatmak için (örneğin, karanlık mod vs aydınlık mod).

• Başlangıçta dosya yolları veya yapılandırma seçenekleri sağlamak için.

• -v veya --debug gibi basit anahtarlar kullanarak ayrıntılı modu veya hata ayıklama özelliklerini etkinleştirmek için.

• Farklı iş akışları için özel argümanlar ileten kısayollar oluşturmak için.

Ana yöntemi dize argümanları kabul edecek şekilde tasarlayarak, uygulamanızın esnekliğini ve uyarlanabilirliğini kolayca genişletebilirsiniz - ek kullanıcı girdi diyaloglarına veya yapılandırma dosyalarına ihtiyaç duymadan.

Sonuç (8:15)

Örnek odaklı açıklaması, C#'ta komut satırı argümanlarını işlemenin karmaşık olmadığını gösterir - sadece her uygulamanın bir giriş noktası (Main) olduğunu ve komut satırından geçen argümanların bu noktaya bir dizi olarak geldiğini anlamaktan ibarettir.

İster konsol uygulamalarıyla ister Windows Forms uygulamalarıyla çalışın, bu kavram, programlarınızın başlangıçta belirtilen komutlara, değerlere ve parametrelere dinamik olarak tepki vermesini sağlar.

Son Alım

Tim Corey'in videosu, C#'ta komut satırı argümanlarının doğru kullanımıyla ilgili net, pratik bir rehber sunar. Main metodunda args parametresinin nasıl çalıştığı anlaşıldığında, geliştiriciler daha sağlam ve yapılandırılabilir uygulamalar için kolaylıkla argümanları oluşturabilir, ayrıştırabilir ve kullanabilir.

Dolayısıyla bir sonraki C# projenizi oluştururken, komut satırı argümanlarının yalnızca teknik bir söz dizimi olmadığını unutmayın — bunlar programınız ile kullanıcıları arasındaki köprüdür ve kodunuza daha fazla güç, esneklik ile gerçek dünya kullanılabilirliği kazandırır.