Tutorial: Membuat pustaka kelas .NET menggunakan Visual Studio Code

Dalam tutorial ini, Anda membuat pustaka utilitas sederhana yang berisi satu metode penanganan string.

Pustaka kelas menentukan jenis dan metode yang dipanggil oleh aplikasi. Jika pustaka menargetkan .NET Standard 2.0, pustaka dapat dipanggil oleh implementasi .NET apa pun (termasuk .NET Framework) yang mendukung .NET Standard 2.0. Jika pustaka menargetkan .NET 9, pustaka dapat dipanggil oleh aplikasi apa pun yang menargetkan .NET 9. Tutorial ini menunjukkan cara menargetkan .NET 9.

Saat membuat pustaka kelas, Anda dapat mendistribusikannya sebagai komponen pihak ketiga atau sebagai komponen yang dibundel dengan satu atau beberapa aplikasi.

Prasyarat

Instruksi penginstalan

Di Windows, file konfigurasi WinGet ini untuk menginstal semua prasyarat. Jika Anda sudah memiliki sesuatu yang terinstal, WinGet akan melewati langkah tersebut.

Unduh file dan klik dua kali untuk menjalankannya.
Baca perjanjian lisensi, ketik y, dan pilih Masukkan saat diminta untuk menerima.
Jika Anda mendapatkan perintah Kontrol Akun Pengguna (UAC) yang berkedip di Taskbar Anda, izinkan penginstalan dilanjutkan.

Pada platform lain, Anda perlu menginstal masing-masing komponen ini secara terpisah.

Unduh penginstal yang direkomendasikan dari halaman unduhan .NET SDK dan klik dua kali untuk menjalankannya. Halaman unduhan mendeteksi platform Anda dan merekomendasikan penginstal terbaru untuk platform Anda.
Unduh penginstal terbaru dari halaman beranda Visual Studio Code dan klik dua kali untuk menjalankannya. Halaman itu juga mendeteksi platform Anda dan tautan harus benar untuk sistem Anda.
Klik tombol "Instal" pada halaman ekstensi C# DevKit. Yang membuka kode Visual Studio, dan menanyakan apakah Anda ingin menginstal atau mengaktifkan ekstensi. Pilih "instal".

Membuat proyek pustaka kelas

Mulailah dengan membuat proyek pustaka kelas .NET bernama "StringLibrary" dan solusi terkait. Solusi berfungsi sebagai kontainer untuk satu atau beberapa proyek. Anda akan menambahkan proyek terkait tambahan ke solusi yang sama.

Mulai Visual Studio Code.
Buka tampilan Explorer dan pilih Buat Proyek .NET. Atau, Anda dapat memunculkan Palet Perintah menggunakan Ctrl+Shift+P (Command+Shift+P di MacOS) lalu mengetik ".NET" dan menemukan dan memilih perintah .NET: Proyek Baru.
Setelah memilih perintah, Anda harus memilih templat proyek. Pilih Pustaka Kelas.
Kemudian pilih lokasi tempat Anda ingin membuat proyek baru.
Kemudian pilih lokasi tempat Anda ingin proyek baru dibuat: Buat folder bernama ClassLibraryProjects dan pilih.
Beri nama proyek StringLibrary, pilih Tampilkan semua opsi templat, pilih .NET 9 dan pilih Buat Proyek.
Beri nama proyek StringLibrary dan pilih Buat Project.
Tekan Enter pada perintah Proyek akan dibuat di <jalur>.
Pastikan pustaka menargetkan .NET 9. Di Explorer, buka StringLibrary/StringLibrary.csproj.

Elemen TargetFramework menunjukkan bahwa proyek menargetkan .NET 9.0.
```
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

</Project>
```
Buka Class1.cs dan ganti kode dengan kode berikut.
```
namespace UtilityLibraries;

public static class StringLibrary
{
    public static bool StartsWithUpper(this string? str)
    {
        if (string.IsNullOrWhiteSpace(str))
            return false;

        return char.IsUpper(str[0]);
    }
}
```
Pustaka kelas, UtilityLibraries.StringLibrary, berisi metode bernama StartsWithUpper. Metode ini mengembalikan nilai Boolean yang menunjukkan apakah instans string saat ini dimulai dengan karakter huruf besar. Standar Unicode membedakan karakter huruf besar dari karakter huruf kecil. Metode Char.IsUpper(Char) mengembalikan true jika karakter adalah huruf besar.

StartsWithUpper diimplementasikan sebagai metode ekstensi sehingga Anda dapat memanggilnya seolah-olah itu adalah anggota kelas String.
Simpan berkas tersebut.
Perluas Penjelajah Solusi di bagian bawah tampilan Penjelajah .

Klik kanan solusi di Penjelajah Solusi dan pilih Build, atau buka Palet Perintah dan pilih .NET: Bangun untuk membangun solusi dan memverifikasi bahwa proyek dikompilasi tanpa kesalahan.

Output terminal terlihat seperti contoh berikut:

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

Menambahkan aplikasi konsol ke solusi

Tambahkan aplikasi konsol yang menggunakan pustaka kelas. Aplikasi akan meminta pengguna untuk memasukkan string dan melaporkan apakah string dimulai dengan karakter huruf besar.

Klik kanan solusi di Penjelajah Solusi dan pilih Proyek Baru , atau di Palet Perintah pilih .NET: Proyek Baru.
Pilih Aplikasi konsol.
Beri nama ShowCase, pilih lokasi default dan pilih Buat Proyek.

Buka ShowCase/Program.cs dan ganti semua kode dengan kode berikut.

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

Kode ini menggunakan variabel row untuk mempertahankan hitungan jumlah baris data yang ditulis ke jendela konsol. Setiap kali lebih besar dari atau sama dengan 25, kode akan menghapus jendela konsol dan menampilkan pesan kepada pengguna.

Program ini meminta pengguna untuk memasukkan string. Ini menunjukkan apakah string dimulai dengan karakter huruf besar. Jika pengguna menekan tombol Enter tanpa memasukkan string, aplikasi berakhir, dan jendela konsol ditutup.

Simpan perubahan Anda.

Menambahkan referensi proyek

Awalnya, proyek aplikasi konsol baru tidak memiliki akses ke pustaka kelas. Untuk mengizinkannya memanggil metode di pustaka kelas, buat referensi proyek ke proyek pustaka kelas.

Di Penjelajah Solusi klik kanan pada proyek ShowCase dan pilih Tambahkan Referensi Proyek.
Pilih StringLibrary.

Menjalankan aplikasi

Pilih Jalankan>Jalankan tanpa debugging.
PilihC# .
Pilih ShowCase.

Jika Anda mendapatkan kesalahan yang mengatakan tidak ada program C# yang dimuat, tutup folder yang telah Anda buka, dan buka folder ShowCase. Kemudian coba jalankan aplikasi lagi.

Cobalah program dengan memasukkan string dan menekan Enter, lalu tekan Enter untuk keluar.

Output terminal terlihat seperti contoh berikut:

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

Sumber daya tambahan

Langkah berikutnya

Dalam tutorial ini, Anda membuat proyek pustaka dan menambahkan proyek aplikasi konsol yang menggunakan pustaka. Dalam tutorial berikutnya, Anda menambahkan proyek pengujian unit ke solusi.

Menguji perpustakaan kelas .NET menggunakan Visual Studio Code

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-03-25