Bagikan melalui


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.

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.

  1. Di jendela mulai, pilih Buat proyek baru.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. 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.

    Screenshot that shows the ASP.NET Core Web App project template highlighted in the New Project dialog box in Visual Studio.

    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.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    Di Penginstal Visual Studio, pilih ASP.NET dan pengembangan web.

    Screenshot shows the dot NET Core cross-platform development workload in the Visual Studio Installer.

    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.

  3. Di jendela Konfigurasikan proyek baru Anda, masukkan MyCoreApp di bidang nama Proyek. Kemudian, pilih Berikutnya.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. 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.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET Core 3.1.

  5. Pilih Buat.

Visual Studio membuka proyek baru Anda.

  1. Di jendela mulai, pilih Buat proyek baru.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. 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.

    Screenshot that shows the ASP.NET Core Web App project template selected and highlighted on the Create a new project page.

    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.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    Di Penginstal Visual Studio, pilih beban kerja ASP.NET dan pengembangan web.

    Screenshot shows the ASP.NET and web development workload in the Visual Studio Installer.

    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.

  3. Di jendela Konfigurasikan proyek baru Anda, masukkan MyCoreApp di bidang nama Proyek. Kemudian, pilih Berikutnya.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. 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.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET 8.0.

  5. 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

  1. Templat proyek membuat solusi dengan satu proyek ASP.NET Core bernama MyCoreApp. Pilih tab Penjelajah Solusi untuk melihat kontennya.

    Screenshot shows the MyCoreApp project selected in the Solution Explorer in Visual Studio.

  2. Luaskan map Halaman.

    Screenshot shows the contents of the Pages folder in the the Solution Explorer in Visual Studio..

  3. Pilih file Index.cshtml, dan lihat file di editor kode.

    Screenshot shows the Index dot c s h t m l file open in the Visual Studio code editor.

  4. 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.

    Screenshot shows Index dot c s h t m l file selected in the Solution Explorer in Visual Studio.

  5. Lihat file Index.cshtml.cs di editor kode.

    Screenshot shows the Index dot c s h t m l dot c s file open in the Visual Studio code editor.

  6. Proyek ini berisi folder wwwroot , yang merupakan akar untuk situs web Anda. Luaskan folder untuk melihat isinya.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    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.

  7. Perluas file appsettings.json untuk melihat appsettings. File Development.json.

    Screenshot shows appsettings dot j son selected and expanded in the Solution Explorer in Visual Studio.

Jalankan, debug, dan buat perubahan

  1. 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.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    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.

  2. Visual Studio meluncurkan jendela browser. Anda kemudian akan melihat halaman Beranda dan Privasi di bilah menu.

  3. Pilih Privasi dari bilah menu. Halaman Privasi di browser merender teks yang diatur dalam file Privacy.cshtml .

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Kembali ke Visual Studio, lalu tekan Shift+F5 untuk menghentikan penelusuran kesalahan. Tindakan ini menutup proyek di jendela browser.

  5. 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"].

    Screenshot shows the Privacy dot c s h t m l file open in the Visual Studio code editor with the updated text.

  6. 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.

    Screenshot shows the Privacy dot c s h t m l file in the Visual Studio code editor with the Quick Actions tooltip exposed for a greyed out using directive.

    Sekarang pilih Pratinjau perubahan untuk melihat perubahan apa.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    Pilih Terapkan. Visual Studio menghapus arahan yang tidak perlu using dari file.

  7. Berikutnya, dalam metode OnGet(), ubah isi ke kode berikut:

    public void OnGet()
    {
       string dateTime = DateTime.Now.ToShortDateString();
       ViewData["TimeStamp"] = dateTime;
    }
    
  8. Perhatikan garis bawah bergelombang muncul di bawah DateTime. Garis bawah bergelombang muncul karena jenis ini tidak berada dalam cakupan.

    Screenshot shows an error mark, in the form of a wavy underline, for DateTime in the Visual Studio code editor.

    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.

    Screenshot shows the Error List toolbar in Visual Studio with DateTime listed.

  9. 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.

    Screenshot shows the Quick Actions options from its drop-down menu with a mouseover on using System.

  10. Tekan F5 untuk membuka proyek Anda di browser web.

  11. Di bagian atas situs web, pilih Privasi untuk melihat perubahan Anda.

    Screenshot showing the updated Privacy page that includes the changes you made.

  12. Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan.

Mengubah halaman Beranda Anda

  1. Di Penjelajah Solusi, perluas folder Pages, lalu pilih Index.cshtml.

    Screenshot shows Index dot c s h t m l selected under the Pages node in the Solution Explorer.

    File Index.cshtml sesuai dengan halaman Beranda Anda di aplikasi web, yang berjalan di browser web.

     Screenshot shows the Home page for the web app in the browser window.

    Di editor kode, Anda akan melihat kode HTML untuk teks yang muncul di halaman Beranda .

    Screenshot shows the Index dot c s h t m l file for the Home page in the Visual Studio code editor.

  2. Ganti teks Selamat Datang dengan Halo Dunia!

    Screenshot shows the Index dot c s h t m l file in the Visual Studio code editor with the Welcome text changed to Hello World!.

  3. Pilih IIS Ekspres atau tekan Ctrl+F5 untuk menjalankan aplikasi dan membukanya di browser web.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. Di browser web, Anda akan melihat perubahan baru di halaman Beranda .

    Screenshot shows the Home page for the web app in the browser window. The updated text says Hello World!

  5. Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan, dan simpan proyek Anda. Anda sekarang dapat menutup Visual Studio.

Tur solusi Anda

  1. Templat proyek membuat solusi dengan satu proyek ASP.NET Core bernama MyCoreApp. Pilih tab Penjelajah Solusi untuk melihat kontennya.

    Screenshot shows the MyCoreApp project selected and its content in the Solution Explorer in Visual Studio.

  2. Luaskan map Halaman.

    Screenshot shows the contents of the Pages folder in the Solution Explorer.

  3. Pilih file Index.cshtml, dan lihat di editor kode.

    Screenshot shows the Index.cshtml file open in the Visual Studio Code editor.

  4. 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.

    Screenshot shows Index.cshtml file selected in the Solution Explorer in Visual Studio.

  5. Lihat file Index.cshtml.cs di editor kode.

    Screenshot shows the Index.cshtml.cs file open in the Visual Studio Code editor.

  6. Proyek ini berisi folder wwwroot , yang merupakan akar untuk situs web Anda. Luaskan folder untuk melihat isinya.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    Anda dapat meletakkan konten situs statis seperti pustaka CSS, gambar, dan JavaScript langsung di jalur tempat Anda menginginkannya.

  7. 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.

    Screenshot shows appsettings.json selected and expanded, which exposes appsettings.Development.json, in the Solution Explorer in Visual Studio.

Jalankan, debug, dan buat perubahan

  1. 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.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    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.

  2. Visual Studio meluncurkan jendela browser. Anda kemudian akan melihat halaman Beranda dan Privasi di bilah menu.

  3. Pilih Privasi dari bilah menu. Halaman Privasi di browser merender teks yang diatur dalam file Privacy.cshtml .

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Kembali ke Visual Studio, lalu tekan Shift+F5 untuk menghentikan penelusuran kesalahan. Tindakan ini menutup proyek di jendela browser.

  5. 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"].

    Screenshot shows the Privacy.cshtml file open in the Visual Studio Code editor with the updated text.

  6. 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.

    Screenshot shows the Privacy.cshtml file in the Visual Studio Code editor with the Quick Actions tooltip open and Preview changes highlighted.

    Sekarang pilih Pratinjau perubahan untuk melihat perubahan apa.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    Pilih Terapkan. Visual Studio menghapus arahan yang tidak perlu using dari file.

  7. 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;
    }
    
  8. Perhatikan bahwa direktif berikut using secara otomatis ditambahkan ke bagian atas file:

    using System.Globalization;
    

    System.Globalizationberisi kelas CultureInfo.

  9. Tekan F5 untuk membuka proyek Anda di browser web.

  10. Di bagian atas situs web, pilih Privasi untuk melihat perubahan Anda.

    Screenshot showing the Privacy page of the MyCoreApp that includes the changes made to add the date.

  11. Tutup browser web, tekan Shift+F5 untuk menghentikan penelusuran kesalahan.

Mengubah halaman Beranda Anda

  1. Di Penjelajah Solusi, perluas folder Pages, lalu pilih Index.cshtml.

    Screenshot shows Index.cshtml selected under the Pages node in the Solution Explorer.

    File Index.cshtml sesuai dengan halaman Beranda Anda di aplikasi web, yang berjalan di browser web.

    Screenshot shows the Home page for the web app in the browser window.

    Di editor kode, Anda akan melihat kode HTML untuk teks yang muncul di halaman Beranda .

    Screenshot shows the Index.cshtml file for the Home page in the Visual Studio Code editor.

  2. Ganti teks Selamat Datang dengan Halo Dunia!

    Screenshot shows the Index.cshtml file in the Visual Studio Code editor with the 'Welcome' text changed to 'Hello World!'.

  3. Pilih IIS Ekspres atau tekan Ctrl+F5 untuk menjalankan aplikasi dan membukanya di browser web.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. Di browser web, Anda akan melihat perubahan baru di halaman Beranda .

    Screenshot shows the Home page for the web app in the browser window. The updated text says 'Hello World!'

  5. 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