Tutorial: Mulai menggunakan C# dan ASP.NET Core di Visual Studio
Dalam tutorial ini untuk pengembangan C# dengan ASP.NET Core, Anda membuat aplikasi web C# ASP.NET Core di Visual Studio.
Tutorial ini akan menunjukkan cara untuk:
- Membuat proyek Visual Studio
- Buat aplikasi web C# ASP.NET Core
- Buat perubahan pada aplikasi web
- Menjelajahi fitur IDE
- Jalankan aplikasi web
Prasyarat
Anda memerlukan Visual Studio untuk menyelesaikan tutorial ini. Kunjungi halaman pengunduhan Visual Studio untuk mendapatkan versi gratis.
Untuk informasi selengkapnya tentang peningkatan ke rilis Visual Studio terbaru, lihat Visual Studio pembaruan.
Untuk menyesuaikan pengalaman Visual Studio Anda, lihat mempersonalisasi IDE dan Editor Visual Studio.
Membuat proyek
Pertama, Anda membuat proyek ASP.NET Core. Jenis proyek dilengkapi dengan semua file templat yang Anda butuhkan untuk membangun situs web yang berfungsi penuh.
Di jendela mulai, pilih Buat proyek baru.
Di jendela Buat proyek baru, pilih C# dari daftar Bahasa. Berikutnya, pilih Windows dari daftar platform, dan Web dari daftar jenis proyek.
Setelah Anda menerapkan filter bahasa, platform, dan jenis proyek, pilih templat ASP.NET Core Web App, lalu pilih Berikutnya.
Catatan
Jika Anda tidak melihat templat ASP.NET Core Web App, Anda dapat menginstalnya dari jendela Buat proyek baru.
Di pesan Tidak menemukan apa yang Anda cari? di bagian bawah daftar templat, pilih tautan Instal alat dan fitur lainnya.
Di Penginstal Visual Studio, pilih ASP.NET dan pengembangan web.
Pilih Ubah di alat penginstal Visual Studio. Anda mungkin diminta untuk menyimpan pekerjaan Anda. Pilih Lanjutkan untuk menginstal beban kerja.
Kembali ke langkah 2 dalam prosedur "Buat proyek" ini.
Di jendela Konfigurasikan proyek baru Anda, masukkan MyCoreApp di bidang nama Proyek. Kemudian, pilih Berikutnya.
Di jendela Informasi tambahan, verifikasi bahwa .NET Core 3.1 muncul di bidang Kerangka Kerja Target.
Dari jendela ini, Anda dapat mengaktifkan dukungan Docker dan menambahkan dukungan autentikasi. Menu drop-down untuk Jenis Autentikasi memiliki empat opsi berikut:
- Tidak Ada: Tidak ada autentikasi.
- Akun individual: Autentikasi ini disimpan dalam database lokal atau berbasis Azure.
- platform identitas Microsoft: Opsi ini menggunakan MICROSOFT Entra ID atau Microsoft 365 untuk autentikasi.
- Windows: Cocok untuk aplikasi intranet.
Biarkan kotak Aktifkan Docker tidak dicentang, dan pilih Tidak Ada untuk Jenis Autentikasi.
Pilih Buat.
Visual Studio membuka proyek baru Anda.
Di jendela mulai, pilih Buat proyek baru.
Di jendela Buat proyek baru, pilih C# dari daftar Bahasa. Berikutnya, pilih Windows dari daftar platform, dan Web dari daftar jenis proyek.
Setelah Anda menerapkan filter bahasa, platform, dan jenis proyek, pilih templat ASP.NET Core Web App, lalu pilih Berikutnya.
Catatan
Jika Anda tidak melihat templat ASP.NET Core Web App, Anda dapat menginstalnya dari jendela Buat proyek baru.
Di pesan Tidak menemukan apa yang Anda cari? di bagian bawah daftar templat, pilih tautan Instal alat dan fitur lainnya.
Di Penginstal Visual Studio, pilih beban kerja ASP.NET dan pengembangan web.
Pilih Ubah di alat penginstal Visual Studio. Anda mungkin diminta untuk menyimpan pekerjaan Anda. Pilih Lanjutkan untuk menginstal beban kerja.
Kembali ke langkah 2 dalam prosedur "Buat proyek" ini.
Di jendela Konfigurasikan proyek baru Anda, masukkan MyCoreApp di bidang nama Proyek. Kemudian, pilih Berikutnya.
Di jendela Informasi tambahan, verifikasi bahwa .NET 8.0 muncul di bidang Kerangka Kerja Target.
Dari jendela ini, Anda dapat mengaktifkan dukungan Docker dan menambahkan dukungan autentikasi. Menu drop-down untuk Jenis Autentikasi memiliki empat opsi berikut:
- Tidak Ada: Tidak ada autentikasi.
- Akun individual: Autentikasi ini disimpan dalam database lokal atau berbasis Azure.
- platform identitas Microsoft: Opsi ini menggunakan MICROSOFT Entra ID atau Microsoft 365 untuk autentikasi.
- Windows: Cocok untuk aplikasi intranet.
Biarkan kotak Aktifkan Docker tidak dicentang, dan pilih Tidak Ada untuk Jenis Autentikasi.
Pilih Buat.
Visual Studio membuka proyek baru Anda.
Tentang solusi Anda
Solusi ini mengikuti pola desain Halaman Razor. Ini berbeda dari pola desain Model-View-Controller (MVC) karena disederhanakan untuk menyertakan model dan kode pengontrol dalam Halaman Razor itu sendiri.
Tur solusi Anda
Templat proyek membuat solusi dengan satu proyek ASP.NET Core bernama MyCoreApp. Pilih tab Penjelajah Solusi untuk melihat kontennya.
Luaskan map Halaman.
Pilih file Index.cshtml, dan lihat file di editor kode.
Setiap file .cshtml memiliki file kode terkait. Untuk membuka file kode di editor, perluas node Index.cshtml di Penjelajah Solusi, dan pilih file Index.cshtml.cs.
Lihat file Index.cshtml.cs di editor kode.
Proyek ini berisi folder wwwroot , yang merupakan akar untuk situs web Anda. Luaskan folder untuk melihat isinya.
Anda dapat meletakkan konten situs statis seperti pustaka CSS, gambar, dan JavaScript langsung di jalur tempat Anda menginginkannya.
Proyek ini juga berisi file konfigurasi yang mengelola aplikasi web pada durasi. Konfigurasi aplikasi default disimpan di appsettings.json. Namun, Anda dapat mengambil alih pengaturan ini dengan menggunakan appsetting. Development.json.
Perluas file appsettings.json untuk melihat appsettings. File Development.json.
Jalankan, debug, dan buat perubahan
Di toolbar, pilih tombol IIS Express untuk membuat dan menjalankan aplikasi dalam mode debug. Atau, tekan F5, atau buka Debug>Mulai Penelusuran Kesalahan dari bilah menu.
Catatan
Jika Anda mendapatkan pesan kesalahan yang mengatakan Tidak dapat tersambung ke server web 'IIS Ekspres', tutup Visual Studio lalu luangkan kembali program sebagai administrator. Anda dapat melakukan tugas ini dengan mengklik kanan ikon Visual Studio dari Menu Mulai, lalu memilih opsi Jalankan sebagai administrator dari menu konteks.
Anda mungkin juga mendapatkan pesan yang menanyakan apakah Anda ingin menerima sertifikat IIS SSL Ekspres. Untuk melihat kode di browser web, pilih Ya, lalu pilih Ya jika Anda menerima pesan peringatan keamanan tindak lanjut.
Visual Studio meluncurkan jendela browser. Anda kemudian akan melihat halaman Beranda dan Privasi di bilah menu.
Pilih Privasi dari bilah menu. Halaman Privasi di browser merender teks yang diatur dalam file Privacy.cshtml .
Kembali ke Visual Studio, lalu tekan Shift+F5 untuk menghentikan penelusuran kesalahan. Tindakan ini menutup proyek di jendela browser.
Di Visual Studio, buka Privacy.cshtml untuk pengeditan. Berikutnya, hapus kalimat, Gunakan halaman ini untuk merinci kebijakan privasi situs Anda dan menggantinya dengan Halaman ini sedang dibangun pada @ViewData["TimeStamp"].
Sekarang, mari kita buat perubahan kode. Pilih Privacy.cshtml.cs. Berikutnya, bersihkan direktif
using
di bagian atas file dengan menggunakan pintasan berikut:Mouseover atau pilih arahan abu-abu
using
. Bola lampu Tindakan Cepat muncul di bawah tanda sisipan atau di margin kiri. Pilih bola lampu, lalu pilih Hapus penggunaan yang tidak perlu.Sekarang pilih Pratinjau perubahan untuk melihat perubahan apa.
Pilih Terapkan. Visual Studio menghapus arahan yang tidak perlu
using
dari file.Berikutnya, dalam metode
OnGet()
, ubah isi ke kode berikut:public void OnGet() { string dateTime = DateTime.Now.ToShortDateString(); ViewData["TimeStamp"] = dateTime; }
Perhatikan garis bawah bergelombang muncul di bawah DateTime. Garis bawah bergelombang muncul karena jenis ini tidak berada dalam cakupan.
Buka toolbar Daftar Kesalahan untuk melihat kesalahan yang sama yang tercantum di sana. Jika Anda tidak melihat toolbar Daftar Kesalahan, buka Tampilkan>Daftar Kesalahan dari bilah menu atas.
Mari kita perbaiki kesalahan ini. Di editor kode, letakkan kursor Anda pada baris yang berisi kesalahan, lalu pilih bola lampu Tindakan Cepat di margin kiri. Kemudian, dari menu drop-down, pilih menggunakan Sistem; untuk menambahkan direktif ini ke bagian atas file Anda dan mengatasi kesalahan.
Tekan F5 untuk membuka proyek Anda di browser web.
Di bagian atas situs web, pilih Privasi untuk melihat perubahan Anda.
Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan.
Mengubah halaman Beranda Anda
Di Penjelajah Solusi, perluas folder Pages, lalu pilih Index.cshtml.
File Index.cshtml sesuai dengan halaman Beranda Anda di aplikasi web, yang berjalan di browser web.
Di editor kode, Anda akan melihat kode HTML untuk teks yang muncul di halaman Beranda .
Ganti teks Selamat Datang dengan Halo Dunia!
Pilih IIS Ekspres atau tekan Ctrl+F5 untuk menjalankan aplikasi dan membukanya di browser web.
Di browser web, Anda akan melihat perubahan baru di halaman Beranda .
Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan, dan simpan proyek Anda. Anda sekarang dapat menutup Visual Studio.
Tur solusi Anda
Templat proyek membuat solusi dengan satu proyek ASP.NET Core bernama MyCoreApp. Pilih tab Penjelajah Solusi untuk melihat kontennya.
Luaskan map Halaman.
Pilih file Index.cshtml, dan lihat di editor kode.
Setiap file .cshtml memiliki file kode terkait. Untuk membuka file kode di editor, perluas node Index.cshtml di Penjelajah Solusi, dan pilih file Index.cshtml.cs.
Lihat file Index.cshtml.cs di editor kode.
Proyek ini berisi folder wwwroot , yang merupakan akar untuk situs web Anda. Luaskan folder untuk melihat isinya.
Anda dapat meletakkan konten situs statis seperti pustaka CSS, gambar, dan JavaScript langsung di jalur tempat Anda menginginkannya.
Proyek ini juga berisi file konfigurasi yang mengelola aplikasi web pada durasi. Konfigurasi aplikasi default disimpan di appsettings.json. Namun, Anda dapat mengambil alih pengaturan ini dengan menggunakan appsetting. Development.json. Perluas file appsettings.json untuk melihat appsettings. File Development.json.
Jalankan, debug, dan buat perubahan
Di toolbar, pilih tombol IIS Express untuk membuat dan menjalankan aplikasi dalam mode debug. Atau, tekan F5, atau buka Debug>Mulai Penelusuran Kesalahan dari bilah menu.
Catatan
Jika Anda mendapatkan pesan kesalahan yang mengatakan Tidak dapat tersambung ke server web 'IIS Ekspres', tutup Visual Studio lalu luangkan kembali program sebagai administrator. Anda dapat melakukan tugas ini dengan mengklik kanan ikon Visual Studio dari Menu Mulai, lalu memilih opsi Jalankan sebagai administrator dari menu konteks.
Anda mungkin juga mendapatkan pesan yang menanyakan apakah Anda ingin menerima sertifikat IIS SSL Ekspres. Untuk melihat kode di browser web, pilih Ya, lalu pilih Ya jika Anda menerima pesan peringatan keamanan tindak lanjut.
Visual Studio meluncurkan jendela browser. Anda kemudian akan melihat halaman Beranda dan Privasi di bilah menu.
Pilih Privasi dari bilah menu. Halaman Privasi di browser merender teks yang diatur dalam file Privacy.cshtml .
Kembali ke Visual Studio, lalu tekan Shift+F5 untuk menghentikan penelusuran kesalahan. Tindakan ini menutup proyek di jendela browser.
Di Visual Studio, buka Privacy.cshtml untuk pengeditan. Berikutnya, hapus kalimat, Gunakan halaman ini untuk merinci kebijakan privasi situs Anda dan menggantinya dengan Halaman ini sedang dibangun pada @ViewData["TimeStamp"].
Sekarang, mari kita buat perubahan kode. Pilih Privacy.cshtml.cs. Kemudian, bersihkan arahan
using
di bagian atas file dengan memilih pintasan berikut:Mouseover atau pilih arahan abu-abu
using
. Bola lampu Tindakan Cepat muncul di bawah tanda sisipan atau di margin kiri. Pilih bola lampu, lalu pilih panah perluas di samping Hapus penggunaan yang tidak perlu.Sekarang pilih Pratinjau perubahan untuk melihat perubahan apa.
Pilih Terapkan. Visual Studio menghapus arahan yang tidak perlu
using
dari file.Selanjutnya, buat string untuk tanggal saat ini yang diformat untuk budaya atau wilayah Anda dengan menggunakan metode DateTime.ToString .
- Argumen pertama untuk metode menentukan bagaimana tanggal harus ditampilkan. Contoh ini menggunakan penentu format (
d
) yang menunjukkan format tanggal pendek. - Argumen kedua adalah objek CultureInfo yang menentukan budaya atau wilayah untuk tanggal tersebut. Argumen kedua menentukan, antara lain, bahasa kata apa pun dalam tanggal, dan jenis pemisah yang digunakan.
Ubah isi metode menjadi
OnGet()
kode berikut:public void OnGet() { string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US")); ViewData["TimeStamp"] = dateTime; }
- Argumen pertama untuk metode menentukan bagaimana tanggal harus ditampilkan. Contoh ini menggunakan penentu format (
Perhatikan bahwa direktif berikut
using
secara otomatis ditambahkan ke bagian atas file:using System.Globalization;
System.Globalization
berisi kelas CultureInfo.Tekan F5 untuk membuka proyek Anda di browser web.
Di bagian atas situs web, pilih Privasi untuk melihat perubahan Anda.
Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan.
Mengubah halaman Beranda Anda
Di Penjelajah Solusi, perluas folder Pages, lalu pilih Index.cshtml.
File Index.cshtml sesuai dengan halaman Beranda Anda di aplikasi web, yang berjalan di browser web.
Di editor kode, Anda akan melihat kode HTML untuk teks yang muncul di halaman Beranda .
Ganti teks Selamat Datang dengan Halo Dunia!
Pilih IIS Ekspres atau tekan Ctrl+F5 untuk menjalankan aplikasi dan membukanya di browser web.
Di browser web, Anda akan melihat perubahan baru di halaman Beranda .
Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan, dan simpan proyek Anda. Anda sekarang dapat menutup Visual Studio.
Langkah berikutnya
Selamat atas penyelesaian tutorial ini! Kami harap Anda menikmati belajar tentang C#, ASP.NET Core, dan IDE Visual Studio. Untuk mempelajari selengkapnya tentang membuat aplikasi web atau situs web dengan C# dan ASP.NET, lanjutkan dengan tutorial berikut:
Atau, pelajari cara membuat kontainer aplikasi web Anda dengan Docker:
Baca juga
Menerbitkan aplikasi web Anda ke Azure App Service dengan menggunakan Visual Studio