Öğretici: Visual Studio Code kullanarak .NET sınıf kitaplığı oluşturma

Bu öğreticide, tek bir dize işleme yöntemi içeren basit bir yardımcı program kitaplığı oluşturacaksınız.

sınıf kitaplığı bir uygulama tarafından çağrılan türleri ve yöntemleri tanımlar. Kitaplık .NET Standard 2.0'ı hedeflerse, .NET Standard 2.0'ı destekleyen herhangi bir .NET uygulaması (.NET Framework dahil) tarafından çağrılabilir. Kitaplık .NET 9'ı hedef alıyorsa, .NET 9'ı hedefleyen herhangi bir uygulama tarafından çağrılabilir. Bu öğretici, .NET 9'un nasıl hedefleneceğini göstermektedir.

Bir sınıf kitaplığı oluşturduğunuzda, bunu üçüncü taraf bir bileşen olarak veya bir veya daha fazla uygulamayla paketlenmiş bir bileşen olarak dağıtabilirsiniz.

Önkoşullar

• En son .NET SDK
• Visual Studio Code düzenleyici
• C# Geliştirme Kiti

Yükleme yönergeleri

Windows'da tüm önkoşulları yüklemek için bu WinGet yapılandırma dosyası kullanılır. Zaten yüklü bir şey varsa WinGet bu adımı atlar.

1. Dosyayı indirin ve çift tıklayarak çalıştırın.
2. Lisans sözleşmesini okuyun, yyazın ve kabul etmek isteyip istemediğiniz sorulduğunda Enter seçin.
3. Görev Çubuğunuzda yanıp sönen bir Kullanıcı Hesabı Denetimi (UAC) istemi alırsanız yüklemenin devam etmesi için izin verin.

Diğer platformlarda, bu bileşenlerin her birini ayrı ayrı yüklemeniz gerekir.

1. Önerilen yükleyiciyi .NET SDK indirme sayfasından indirin ve çift tıklayarak çalıştırın. İndirme sayfası platformunuzu algılar ve platformunuz için en son yükleyiciyi önerir.
2. Visual Studio Code giriş sayfasından en son yükleyiciyi indirin ve çift tıklayarak çalıştırın. Bu sayfa ayrıca platformunuzu algılar ve bağlantı sisteminiz için doğru olmalıdır.
3. C# DevKit uzantısı sayfasındaki "Yükle" düğmesine tıklayın. Bu, Visual Studio code'u açar ve uzantıyı yüklemek mi yoksa etkinleştirmek mi istediğinizi sorar. "Yükle" seçeneğini belirleyin.

Sınıf kitaplığı projesi oluşturma

"StringLibrary" adlı bir .NET sınıf kitaplığı projesi ve ilişkili bir çözüm oluşturarak başlayın. Çözüm, bir veya daha fazla proje için kapsayıcı görevi görür. Aynı çözümdeki projelere ek olarak, ilgili projeler ekleyeceksiniz.

1. Visual Studio Code'ı başlatın.

2. Gezgin görünümüne gidin ve .NET Projesi oluşturseçin. Alternatif olarak, Ctrl+Shift+P (MacOS'ta Command+Shift+P) tuşlarını kullanarak Komut Paleti'ni açabilir ve ardından ".NET" yazıp .NET: Yeni Proje komutunu bulup seçebilirsiniz.

3. Komutu seçtikten sonra proje şablonunu seçmeniz gerekir. Sınıf Kitaplığı'nı seçin.

4. Ardından yeni projenin oluşturulmasını istediğiniz konumu seçin.

5. Ardından yeni projenin oluşturulmasını istediğiniz konumu seçin: ClassLibraryProjects adlı bir klasör oluşturun ve seçin.

6. Projeyi StringLibrary adlandırın, tüm şablon seçeneklerini göster'i seçin, .NET 9'i seçin ve ProjectOluştur'u seçin.

7. Projeyi StringLibrary olarak adlandırın ve Proje Oluştur'i seçin.

8. Proje, <yol> içinde oluşturulacak isteminde Enter tuşuna basın.

9. Kitaplığın .NET 9'u hedeflediğinden emin olmak için kontrol edin. Exploreriçinde, StringLibrary/StringLibrary.csprojaçın.

   TargetFramework öğesi, projenin .NET 9.0'a hedeflediğini gösterir.

   <Project Sdk="Microsoft.NET.Sdk">
   
     <PropertyGroup>
       <TargetFramework>net9.0</TargetFramework>
     </PropertyGroup>
   
   </Project>
   

10. Class1.cs açın ve kodu aşağıdaki kodla değiştirin.

    namespace UtilityLibraries;
    
    public static class StringLibrary
    {
        public static bool StartsWithUpper(this string? str)
        {
            if (string.IsNullOrWhiteSpace(str))
                return false;
    
            return char.IsUpper(str[0]);
        }
    }
    

    UtilityLibraries.StringLibrarysınıf kitaplığı, StartsWithUpperadlı bir yöntem içerir. Bu yöntem, geçerli dize örneğinin büyük harf karakterle başlayıp başlamayacağını gösteren bir Boolean değeri döndürür. Unicode standardı, büyük harf karakterlerini küçük harf karakterlerinden ayırır. Char.IsUpper(Char) yöntemi, bir karakter büyük harfse true döndürür.

    StartsWithUpper, sınıfının bir üyesiymiş gibi çağırabilmeniz için String uzantısı yöntemi olarak uygulanır.

11. Dosyayı kaydedin.

12. Çözüm Gezgini, Gezgini görünümünün alt kısmında genişletin.

13. Çözüm Gezgini çözüme sağ tıklayın ve Derleme seçin veya Komut Paleti'ni açıp .NET: Derleme'ni seçerek çözümü derleyin ve projenin hatasız derlendiğini doğrulayın.

    Terminal çıkışı aşağıdaki örneğe benzer:

    Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
    Copyright (C) Microsoft Corporation. All rights reserved.
      Determining projects to restore...
      All projects are up-to-date for restore.
      StringLibrary -> C:\Projects\ClassLibraryProjects\StringLibrary\bin\Debug\net9.0\StringLibrary.dll
    Build succeeded.
        0 Warning(s)
        0 Error(s)
    Time Elapsed 00:00:02.78
    

Çözüme konsol uygulaması ekleme

Sınıf kitaplığını kullanan bir konsol uygulaması ekleyin. Uygulama, kullanıcıdan bir dize girmesini ister ve dizenin büyük harf karakterle başlayıp başlamadığını bildirir.

1. Çözüm Gezgini çözüme sağ tıklayın ve Yeni Proje 'i seçin veya Komut Paleti'nde .NET: Yeni Projeöğesini seçin.

2. Konsol uygulaması'nu seçin.

3. ShowCase adını verin, varsayılan konumu seçin ve proje oluşturseçin.

4. ShowCase/Program.cs açın ve tüm kodu aşağıdaki kodla değiştirin.

   using System;
   using UtilityLibraries;
   
   class Program
   {
       static void Main(string[] args)
       {
           int row = 0;
   
           do
           {
               if (row == 0 || row >= 25)
                   ResetConsole();
   
               string? input = Console.ReadLine();
               if (string.IsNullOrEmpty(input)) break;
               Console.WriteLine($"Input: {input} {"Begins with uppercase? ",30}: " +
                                 $"{(input.StartsWithUpper() ? "Yes" : "No")}{Environment.NewLine}");
               row += 3;
           } while (true);
           return;
   
           // Declare a ResetConsole local method
           void ResetConsole()
           {
               if (row > 0)
               {
                   Console.WriteLine("Press any key to continue...");
                   Console.ReadKey();
               }
               Console.Clear();
               Console.WriteLine($"{Environment.NewLine}Press <Enter> only to exit; otherwise, enter a string and press <Enter>:{Environment.NewLine}");
               row = 3;
           }
       }
   }
   

   Kod, konsol penceresine yazılan veri satırlarının sayısını korumak için row değişkenini kullanır. 25'ten büyük veya 25'e eşit olduğunda kod konsol penceresini temizler ve kullanıcıya bir ileti görüntüler.

   Program, kullanıcıdan bir dize girmesini ister. Dizgenin büyük harf karakterle başlayıp başlamadığını gösterir. Kullanıcı bir dize girmeden enter tuşuna basarsa uygulama sona erer ve konsol penceresi kapanır.

5. Değişikliklerinizi kaydedin.

Proje referansı ekleyin

Başlangıçta, yeni konsol uygulaması projesinin sınıf kitaplığına erişimi yoktur. Sınıf kitaplığında yöntemleri çağırmasına izin vermek için, sınıf kitaplığı projesine bir proje başvurusu oluşturun.

1. Çözüm Gezgini'ndeShowCase projesine sağ tıklayın ve Proje Başvurusu Ekleöğesini seçin.

2. StringLibrary'yi seçin.

Uygulamayı çalıştırma

1. çalıştır>hata ayıklamadan çalıştır'ıseçin.

2. C# seçeneğini belirleyin.

3. ShowCaseseçin.

   C# programının yüklenmediğini belirten bir hata alırsanız, açtığınız klasörü kapatın ve ShowCase klasörünü açın. Ardından uygulamayı yeniden çalıştırmayı deneyin.

4. Dizeleri girip Enter basarak programı deneyin, ardından çıkmak için Enter basın.

   Terminal çıkışı aşağıdaki örneğe benzer:

   Press <Enter> only to exit; otherwise, enter a string and press <Enter>:
   
   A string that starts with an uppercase letter
   Input: A string that starts with an uppercase letter
   Begins with uppercase? : Yes
   
   a string that starts with a lowercase letter
   Input: a string that starts with a lowercase letter
   Begins with uppercase? : No
   

Ek kaynaklar

• .NET CLI ile kitaplık geliştirme
• .NET Standard sürümleri ve desteklediği platformlar.

Sonraki adımlar

Bu öğreticide, bir kitaplık projesi oluşturdunuz ve kitaplığı kullanan bir konsol uygulaması projesi eklediniz. Sonraki öğreticide çözüme bir birim testi projesi ekleyebilirsiniz.

Visual Studio Code kullanarak .NET ile bir .NET sınıf kitaplığını test edin