Templat default untuk dotnet new

Saat menginstal SDK .NET, Anda menerima lebih dari satu lusin template bawaan untuk membuat proyek dan file, termasuk aplikasi konsol, pustaka kelas, proyek uji unit, aplikasi ASP.NET Core (termasuk Proyek Angular dan React), dan file konfigurasi. Untuk mencantumkan templat bawaan, jalankan dotnet new list perintah :

dotnet new list

Opsi templat

Templat yang dikirim dengan .NET SDK memiliki opsi khusus templat. Untuk memperlihatkan opsi tambahan yang tersedia untuk templat, gunakan --help opsi dengan argumen nama templat, misalnya: dotnet new console --help. Bagian khusus templat dalam artikel ini juga menjelaskan opsi.

Jika templat mendukung beberapa bahasa pemrograman, --help opsi akan menampilkan bantuan untuk templat dalam bahasa default. Dengan menggabungkannya dengan --language opsi , Anda dapat melihat bantuan untuk bahasa lain: dotnet new console --help --language F#.

Templat yang telah diinstal sebelumnya

Tabel berikut ini memperlihatkan templat yang telah diinstal sebelumnya dengan .NET SDK. Bahasa default untuk templat ditampilkan di dalam tanda kurung siku. Untuk melihat opsi khusus templat, pilih tautan nama pendek.

Templat Nama pendek Bahasa Tag Pengenalan
API ASP.NET Core webapiaot [C#] Web/Web API/API/Layanan 8.0
pengontrol API inti ASP.NET apicontroller [C#] Web/ASP.NET 8.0
ASP.NET Core Kosong web [C#], F# Web/Kosong 1.0
API Web ASP.NET Core webapi [C#], F# Web/Web API/API/Layanan/WebAPI 1.0
Aplikasi web ASP.NET Core (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
Aplikasi Web ASP.NET Core webapp, razor [C#] Halaman Web/MVC/Razor 2.2, 2.0
Layanan ASP.NET Core gRPC grpc [C#] Web/gRPC 3.0
Blazor Aplikasi Web blazor [C#] Web/Blazor 8.0.100
Blazor WebAssembly Aplikasi Mandiri blazorwasm [C#] Web/Blazor//WebAssemblyPWA 3.1.300
Pustaka kelas classlib [C#], F#, VB Umum/Pustaka 1.0
Aplikasi Konsol console [C#], F#, VB Umum/Konsol 1.0
File Directory.Build.props buildprops Konfigurasi 8.0.100
File Directory.Build.targets buildtargets Konfigurasi 8.0.100
File manifes alat lokal Dotnet tool-manifest Konfigurasi 3.0
File EditorConfig editorconfig Konfigurasi 6.0
File .gitignore gitignore Konfigurasi 3.0
file global.json globaljson Konfigurasi 2.0
Kelas Uji MSTest mstest-class [C#], F#, VB Uji/MSTest 1.0
Proyek Uji MSTest mstest [C#], F#, VB Uji/MSTest 1.0
Item Uji NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
Proyek Pengujian NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Konfigurasi NuGet nugetconfig Konfigurasi 1.0
File Buffer Protokol proto Web/gRPC 3.0
Pustaka Kelas Razor razorclasslib [C#] Pustaka Kelas Web/Razor/Pustaka/Razor 2.1
Komponen Razor razorcomponent [C#] Web/ASP.NET 3.0
Halaman Razor page [C#] Web/ASP.NET 2.0
File Solusi sln Solusi 1.0
Konfigurasi Web webconfig Konfigurasi 1.0
Aplikasi Formulir Windows (WinForms) winforms [C#], VB Common/WinForms 3.0 (5.0 untuk VB)
Pustaka Kelas Formulir Windows (WinForms) winformslib [C#], VB Common/WinForms 3.0 (5.0 untuk VB)
Layanan Pekerja worker [C#] Umum/Pekerja/Web 3.0
Aplikasi WPF wpf [C#], VB Common/WPF 3.0 (5.0 untuk VB)
Pustaka Kelas WPF wpflib [C#], VB Common/WPF 3.0 (5.0 untuk VB)
Pustaka Kontrol Kustom WPF wpfcustomcontrollib [C#], VB Common/WPF 3.0 (5.0 untuk VB)
Pustaka Kontrol Pengguna WPF wpfusercontrollib [C#], VB Common/WPF 3.0 (5.0 untuk VB)
Proyek Pengujian xUnit xunit [C#], F#, VB Test/xUnit 1.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0

buildprops

Membuat file Directory.Build.props untuk menyesuaikan properti MSBuild untuk seluruh pohon folder. Untuk informasi selengkapnya, lihat Menyesuaikan build Anda.

  • --inherit

    Jika ditentukan, menambahkan elemen Impor untuk file Directory.Build.props terdekat dalam hierarki direktori induk. Secara default, file Directory.Build.props tidak mewarisi dari direktori induk, jadi mengaktifkan opsi ini memungkinkan Anda untuk membangun hierarki kustomisasi folder-by-folder.

  • --use-artifacts

    Jika ditentukan, menambahkan properti untuk mengaktifkan tata letak output artefak. Ini adalah pola umum untuk proyek yang menghasilkan artefak build, seperti paket NuGet, yang ditempatkan dalam struktur folder umum. Untuk informasi selengkapnya, lihat Tata letak output Artefak.

buildtargets

Membuat file Directory.Build.targets untuk menyesuaikan target dan tugas MSBuild untuk seluruh pohon folder. Untuk informasi selengkapnya, lihat Menyesuaikan build Anda.

  • --inherit

    Jika ditentukan, menambahkan elemen Impor untuk file Directory.Build.targets terdekat dalam hierarki direktori induk. Secara default, file Directory.Build.targets tidak diwarisi dari direktori induk, jadi mengaktifkan opsi ini memungkinkan Anda untuk membangun hierarki kustomisasi folder-by-folder.

console

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0

    Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 9 SDK yang terinstal, maka satu-satunya nilai yang tersedia untuk --framework adalah net9.0. Jika, misalnya, Anda menginstal .NET 8 SDK, nilai net8.0 menjadi tersedia untuk --framework. Jadi dengan menentukan --framework net8.0 Anda dapat menargetkan .NET 8 bahkan saat menjalankan dotnet new di .NET 9 SDK.

    Atau, untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, Anda mungkin dapat melakukannya dengan menginstal paket NuGet untuk templat. Jenis proyek umum, web, dan SPA menggunakan paket yang berbeda per moniker kerangka kerja target (TFM). Misalnya, untuk membuat console proyek yang menargetkan netcoreapp1.0, jalankan dotnet new install pada Microsoft.DotNet.Common.ProjectTemplates.1.x.

  • --langVersion <VERSION_NUMBER>

    LangVersion Mengatur properti dalam file proyek yang dibuat. Misalnya, gunakan --langVersion 7.3 untuk menggunakan C# 7.3. Tidak didukung untuk F#.

    Untuk daftar versi C# default, lihat Default.

  • --no-restore

    Jika ditentukan, tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false. Hanya tersedia untuk C#.

classlib

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Nilai: net9.0, , net8.0atau net7.0 untuk membuat Pustaka Kelas .NET, atau netstandard2.1netstandard2.0 untuk membuat Pustaka Kelas Standar .NET. Nilai default untuk .NET SDK 9.0.x adalah net9.0.

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --langVersion <VERSION_NUMBER>

    LangVersion Mengatur properti dalam file proyek yang dibuat. Misalnya, gunakan --langVersion 7.3 untuk menggunakan C# 7.3. Tidak didukung untuk F#.

    Untuk daftar versi C# default, lihat Default.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

wpf, , wpflibwpfcustomcontrollib,wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Untuk .NET 9 SDK, nilai defaultnya adalah net9.0.

  • --langVersion <VERSION_NUMBER>

    LangVersion Mengatur properti dalam file proyek yang dibuat. Misalnya, gunakan --langVersion 7.3 untuk menggunakan C# 7.3.

    Untuk daftar versi C# default, lihat Default.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    LangVersion Mengatur properti dalam file proyek yang dibuat. Misalnya, gunakan --langVersion 7.3 untuk menggunakan C# 7.3.

    Untuk daftar versi C# default, lihat Default.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

worker, grpc

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Nilai default untuk .NET 9 SDK adalah net9.0.

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

mstest

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 9 SDK yang terinstal, maka satu-satunya nilai yang tersedia untuk --framework adalah net9.0. Jika Anda menginstal, misalnya, .NET 8 SDK, nilai net8.0 tersedia untuk --framework. Jadi dengan menentukan --framework net8.0 Anda dapat menargetkan .NET 8 bahkan saat menjalankan dotnet new di .NET 9 SDK.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --sdk

    Gunakan gaya proyek MSTest.Sdk.

  • --test-runner <TEST_RUNNER>

    Runner/platform untuk proyek pengujian. Nilai yang mungkin adalah:

    • VSTest - Platform VSTest (Default).
    • MSTest - Microsoft. Testing.Platform (MTP).

  • --coverage-tool <COVERAGE_TOOL>

    Alat cakupan yang digunakan untuk proyek pengujian. Nilai yang mungkin adalah:

    • Microsoft.CodeCoverage - Cakupan Kode Microsoft (Default).
    • coverlet - alat cakupan coverlet.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Profil ekstensi SDK saat menggunakan MTP. Nilai yang mungkin adalah:

    • Default - Profil ekstensi default (Default).
    • None - Tidak ada ekstensi yang diaktifkan.
    • AllMicrosoft - Aktifkan semua ekstensi yang dikirim oleh Microsoft (termasuk ekstensi dengan lisensi terbatas).

  • --fixture <FIXTURE>

    Jenis perlengkapan untuk disertakan dalam proyek pengujian. Nilai yang mungkin adalah:

    • None - Tidak ada metode perlengkapan.
    • AssemblyInitialize - AssemblyInitialize metode fikstur.
    • AssemblyCleanup - Metode perlengkapan AssemblyCleanup.
    • ClassInitialize - Metode perlengkapan ClassInitialize.
    • ClassCleanup - Metode perlengkapan ClassCleanup.
    • TestInitialize - Metode perlengkapan TestInitialize.
    • TestCleanup - Metode perlengkapan TestCleanup.

    Di mana beberapa nilai diizinkan.

  • -p|--enable-pack

    Mengaktifkan pengemasan untuk proyek menggunakan paket dotnet.

mstest-class

  • --fixture <FIXTURE>

    Jenis perlengkapan untuk disertakan dalam proyek pengujian. Nilai yang mungkin adalah:

    • None - Tidak ada metode perlengkapan.
    • AssemblyInitialize - AssemblyInitialize metode fikstur.
    • AssemblyCleanup - Metode perlengkapan AssemblyCleanup.
    • ClassInitialize - Metode perlengkapan ClassInitialize.
    • ClassCleanup - Metode perlengkapan ClassCleanup.
    • TestInitialize - Metode perlengkapan TestInitialize.
    • TestCleanup - Metode perlengkapan TestCleanup.

    Di mana beberapa nilai diizinkan.

xunit

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 9 SDK yang terinstal, maka satu-satunya nilai yang tersedia untuk --framework adalah net9.0. Jika Anda menginstal, misalnya, .NET 8 SDK, nilai net8.0 tersedia untuk --framework. Jadi dengan menentukan --framework net8.0 Anda dapat menargetkan .NET 8 bahkan saat menjalankan dotnet new di .NET 9 SDK.

  • -p|--enable-pack

    Mengaktifkan pengemasan untuk proyek menggunakan paket dotnet.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

nunit

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 9 SDK yang terinstal, maka satu-satunya nilai yang tersedia untuk --framework adalah net9.0. Jika Anda menginstal, misalnya, .NET 8 SDK, nilai net8.0 tersedia untuk --framework. Jadi dengan menentukan --framework net8.0 Anda dapat menargetkan .NET 8 bahkan saat menjalankan dotnet new di .NET 9 SDK.

  • -p|--enable-pack

    Mengaktifkan pengemasan untuk proyek menggunakan paket dotnet.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

page

  • -na|--namespace <NAMESPACE_NAME>

    Namespace untuk kode yang dihasilkan. Nilai defaultnya adalah MyApp.Namespace.

  • -np|--no-pagemodel

    Membuat halaman tanpa PageModel.

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Namespace untuk kode yang dihasilkan. Nilai defaultnya adalah MyApp.Namespace.

blazor

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Templat ini tersedia untuk .NET 8 atau yang lebih baru.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari aplikasi yang dihasilkan.

  • -int|--interactivity <None|Server|Webassembly|Auto >

    Menentukan mode render interaktif mana yang akan digunakan untuk komponen interaktif. Nilai yang mungkin adalah:

    • None - Tidak ada interaktivitas (penyajian sisi server statis saja).
    • Server - (Default) Menjalankan aplikasi di server dengan penyajian sisi server interaktif.
    • WebAssembly - Menjalankan aplikasi menggunakan penyajian sisi klien di browser dengan WebAssembly.
    • Auto - Menggunakan penyajian sisi server interaktif saat mengunduh Blazor bundel dan mengaktifkan Blazor runtime pada klien, lalu menggunakan penyajian sisi klien dengan WebAssembly.

  • --empty

    Menghilangkan halaman sampel dan gaya yang menunjukkan pola penggunaan dasar.

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • Individual - Autentikasi individual.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk Individual autentikasi.

  • -ai|--all-interactive

    Membuat setiap halaman interaktif dengan menerapkan mode render interaktif di tingkat atas. Jika false, halaman menggunakan penyajian sisi server statis secara default dan dapat ditandai interaktif berdasarkan per halaman atau per komponen. Opsi ini hanya efektif jika -i|--interactivity opsi tidak diatur ke None.

  • --no-https

    Menonaktifkan HTTPS. Opsi ini hanya berlaku jika Individual tidak dipilih untuk opsi .-au|--auth

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main dihasilkan alih-alih pernyataan tingkat atas.

web

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --no-https

    Menonaktifkan HTTPS.

  • --kestrelHttpPort

    Nomor port yang akan digunakan untuk titik akhir HTTP di launchSettings.json.

  • --kestrelHttpsPort

    Nomor port yang digunakan untuk titik akhir HTTPS di launchSettings.json. Opsi ini tidak berlaku ketika parameter no-https digunakan (tetapi no-https diabaikan ketika pengaturan autentikasi individu atau organisasi dipilih untuk --auth).

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • Individual - Autentikasi individual.
    • IndividualB2C - Autentikasi individual dengan Azure AD B2C.
    • SingleOrg - Autentikasi organisasi untuk satu penyewa. Penyewa ID Eksternal Entra juga menggunakan SingleOrg.
    • MultiOrg - Autentikasi organisasi untuk beberapa penyewa.
    • Windows - Autentikasi Windows.

  • --aad-b2c-instance <INSTANCE>

    Instans Azure Active Directory B2C untuk disambungkan. Gunakan dengan IndividualB2C autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    ID kebijakan masuk dan pendaftaran untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • -rp|--reset-password-policy-id <ID>

    ID kebijakan kata sandi reset untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • -ep|--edit-profile-policy-id <ID>

    ID kebijakan edit profil untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • --aad-instance <INSTANCE>

    Instans Azure Active Directory untuk disambungkan. Gunakan dengan SingleOrg atau MultiOrg autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/.

  • --client-id <ID>

    ID Klien untuk proyek ini. Gunakan dengan IndividualB2C, SingleOrg, atau MultiOrg autentikasi. Nilai defaultnya adalah 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Domain untuk penyewa direktori. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId direktori yang akan disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Jalur permintaan dalam jalur dasar aplikasi dari URI pengalihan. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah /signin-oidc.

  • -r|--org-read-access

    Memungkinkan aplikasi ini akses baca ke direktori. Hanya berlaku untuk SingleOrg atau MultiOrg autentikasi.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • --no-https

    Menonaktifkan HTTPS. Opsi ini hanya berlaku jika Individual, IndividualB2C, SingleOrg, atau MultiOrg tidak digunakan.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk Individual atau IndividualB2C autentikasi.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-browserlink

    Termasuk BrowserLink dalam proyek.

  • -rrc|--razor-runtime-compilation

    Menentukan apakah proyek dikonfigurasi untuk menggunakan kompilasi runtime Razor di build Debug.

  • --kestrelHttpPort

    Nomor port yang akan digunakan untuk titik akhir HTTP di launchSettings.json.

  • --kestrelHttpsPort

    Nomor port yang digunakan untuk titik akhir HTTPS di launchSettings.json. Opsi ini tidak berlaku ketika parameter no-https digunakan (tetapi no-https diabaikan ketika pengaturan autentikasi individu atau organisasi dipilih untuk --auth).

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

razorclasslib

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • -s|--support-pages-and-views

    Mendukung penambahan halaman Razor tradisional dan Tampilan selain komponen ke pustaka ini.

webapiaot

Membuat proyek API web dengan penerbitan AOT diaktifkan. Untuk informasi selengkapnya, lihat Penyebaran AOT asli dan templat API Web (AOT Asli).

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • IndividualB2C - Autentikasi individual dengan Azure AD B2C.
    • SingleOrg - Autentikasi organisasi untuk satu penyewa. Penyewa ID Eksternal Entra juga menggunakan SingleOrg.
    • Windows - Autentikasi Windows.

  • --aad-b2c-instance <INSTANCE>

    Instans Azure Active Directory B2C untuk disambungkan. Gunakan dengan IndividualB2C autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/tfp/.

  • -minimal|--use-minimal-apis

    Buat proyek yang menggunakan API minimal ASP.NET Core. Defaultnya adalah false, tetapi opsi ini ditimpa oleh -controllers. Karena default untuk -controllers adalah false, memasukkan dotnet new webapi tanpa menentukan salah satu opsi membuat proyek API minimal.

  • -ssp|--susi-policy-id <ID>

    ID kebijakan masuk dan pendaftaran untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • --aad-instance <INSTANCE>

    Instans Azure Active Directory untuk disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/.

  • --client-id <ID>

    ID Klien untuk proyek ini. Gunakan dengan IndividualB2C atau SingleOrg autentikasi. Nilai defaultnya adalah 11111111-1111-1111-11111111111111111.

  • -controllers|--use-controllers

    Apakah akan menggunakan pengontrol alih-alih API minimal. Jika opsi ini dan -minimal ditentukan, opsi ini akan mengambil alih nilai yang ditentukan oleh -minimal. Defaultnya adalah false. Tersedia sejak .NET 8 SDK.

  • --domain <DOMAIN>

    Domain untuk penyewa direktori. Gunakan dengan IndividualB2C atau SingleOrg autentikasi. Nilai defaultnya adalah qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId direktori yang akan disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Memungkinkan aplikasi ini akses baca ke direktori. Hanya berlaku untuk SingleOrg autentikasi.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • --no-openapi

    Menonaktifkan dukungan OpenAPI (Swagger). AddOpenApi dan MapOpenApi tidak dipanggil.

  • --no-https

    Menonaktifkan HTTPS. Tidak ada profil peluncuran https yang dibuat di launchSettings.json. app.UseHstsdan app.UseHttpsRedirection tidak dipanggil dalam Startup.cs Program.cs/. Opsi ini hanya berlaku jika IndividualB2C atau SingleOrg tidak digunakan untuk autentikasi.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk IndividualB2C autentikasi.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

apicontroller

Pengontrol API dengan atau tanpa tindakan baca/tulis.

  • -p:n|--name <NAME>

    Namespace untuk kode yang dihasilkan. Defaultnya adalah MyApp.Namespace.

  • -ac|--actions

    Buat pengontrol dengan tindakan baca/tulis. Defaultnya adalah false.

globaljson

  • --sdk-version <VERSION_NUMBER>

    Menentukan versi .NET SDK yang akan digunakan dalam file global.json .

  • --roll-forward <ROLL_FORWARD_POLICY>

    Kebijakan roll-forward yang akan digunakan saat memilih versi SDK, baik sebagai fallback saat versi SDK tertentu hilang atau sebagai arahan untuk menggunakan versi yang lebih baru. Untuk informasi selengkapnya, lihat global-json.

  • --test-runner <TEST_RUNNER>

    Opsi ini diperkenalkan di .NET 10 SDK dan menentukan runner pengujian yang akan digunakan, baik VSTest atau MTP. Defaultnya adalah VSTest.

sln

Membuat file solusi kosong yang tidak berisi proyek.

Catatan

Di .NET SDK 9.0.200 dan yang --format lebih baru, templat ini mendukung opsi untuk memilih antara sln dan slnx format. Dimulai dengan .NET 10, format defaultnya adalah slnx.

editorconfig

Membuat file .editorconfig untuk mengonfigurasi preferensi gaya kode.

  • --empty

    Membuat .editorconfig kosong alih-alih default untuk .NET.

Templat yang dihentikan

Tabel berikut ini memperlihatkan templat yang telah dihentikan dan tidak lagi diinstal sebelumnya dengan .NET SDK. Untuk melihat opsi khusus templat, pilih tautan nama pendek.

Templat Nama pendek Bahasa Tag Dihentikan sejak
ASP.NET Core dengan Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core dengan React.js react [C#] Web/MVC/SPA 8.0
Blazor Aplikasi Server blazorserver [C#] Web/Blazor 8.0
Blazor Aplikasi Server Kosong blazorserver-empty [C#] Web/Blazor 8.0
Blazor WebAssembly Aplikasi Kosong blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

angular, react

Dihentikan sejak .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan.

    Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • Individual - Autentikasi individual.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --no-https

    Menonaktifkan HTTPS. Opsi ini hanya berlaku jika autentikasi adalah None.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk Individual atau IndividualB2C autentikasi.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Catatan

    Namun, tidak ada templat React untuk net8.0, jika Anda tertarik untuk mengembangkan aplikasi React dengan ASP.NET Core, lihat Gambaran Umum Aplikasi Halaman Tunggal (SPAs) di ASP.NET Core.

    Versi SDK Nilai default
    7,0 net7.0

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --kestrelHttpPort

    Nomor port yang akan digunakan untuk titik akhir HTTP di launchSettings.json.

  • --kestrelHttpsPort

    Nomor port yang digunakan untuk titik akhir HTTPS di launchSettings.json. Opsi ini tidak berlaku ketika parameter no-https digunakan (tetapi no-https diabaikan ketika pengaturan autentikasi individu atau organisasi dipilih untuk --auth).

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

blazorserver

Dihentikan sejak .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • Individual - Autentikasi individual.
    • IndividualB2C - Autentikasi individual dengan Azure AD B2C.
    • SingleOrg - Autentikasi organisasi untuk satu penyewa. Penyewa ID Eksternal Entra juga menggunakan SingleOrg.
    • MultiOrg - Autentikasi organisasi untuk beberapa penyewa.
    • Windows - Autentikasi Windows.

  • --aad-b2c-instance <INSTANCE>

    Instans Azure Active Directory B2C untuk disambungkan. Gunakan dengan IndividualB2C autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    ID kebijakan masuk dan pendaftaran untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • -rp|--reset-password-policy-id <ID>

    ID kebijakan kata sandi reset untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • -ep|--edit-profile-policy-id <ID>

    ID kebijakan edit profil untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • --aad-instance <INSTANCE>

    Instans Azure Active Directory untuk disambungkan. Gunakan dengan SingleOrg atau MultiOrg autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/.

  • --client-id <ID>

    ID Klien untuk proyek ini. Gunakan dengan IndividualB2C, SingleOrg, atau MultiOrg autentikasi. Nilai defaultnya adalah 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Domain untuk penyewa direktori. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah qualified.domain.name.

  • --tenant-id <ID>

    ID TenantId direktori yang akan disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Jalur permintaan dalam jalur dasar aplikasi dari URI pengalihan. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah /signin-oidc.

  • -r|--org-read-access

    Memungkinkan aplikasi ini akses baca ke direktori. Hanya berlaku untuk SingleOrg atau MultiOrg autentikasi.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • --no-https

    Menonaktifkan HTTPS. Opsi ini hanya berlaku jika Individual, IndividualB2C, SingleOrg, atau MultiOrg tidak digunakan untuk --auth.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk Individual atau IndividualB2C autentikasi.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --kestrelHttpPort

    Nomor port yang akan digunakan untuk titik akhir HTTP di launchSettings.json.

  • --kestrelHttpsPort

    Nomor port yang digunakan untuk titik akhir HTTPS di launchSettings.json. Opsi ini tidak berlaku ketika parameter no-https digunakan (tetapi no-https diabaikan ketika pengaturan autentikasi individu atau organisasi dipilih untuk --auth).

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

blazorwasm

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan.

    Tabel berikut ini mencantumkan nilai default sesuai dengan nomor versi SDK yang Anda gunakan:

    Versi SDK Nilai default
    10.0 net10.0
    9.0 net9.0
    8.0 net8.0

    Untuk membuat proyek yang menargetkan kerangka kerja yang lebih lama dari SDK yang Anda gunakan, lihat --framework untuk console proyek sebelumnya di artikel ini.

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • -ho|--hosted

    Menyertakan host ASP.NET Core untuk BlazorWebAssembly aplikasi.

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Nilai yang mungkin adalah:

    • None - Tidak ada autentikasi (Default).
    • Individual - Autentikasi individual.
    • IndividualB2C - Autentikasi individual dengan Azure AD B2C.
    • SingleOrg - Autentikasi organisasi untuk satu penyewa. Penyewa ID Eksternal Entra juga menggunakan SingleOrg.

  • --authority <AUTHORITY>

    Otoritas penyedia OIDC. Gunakan dengan Individual autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/.

  • --aad-b2c-instance <INSTANCE>

    Instans Azure Active Directory B2C untuk disambungkan. Gunakan dengan IndividualB2C autentikasi. Nilai defaultnya adalah https://aadB2CInstance.b2clogin.com/.

  • -ssp|--susi-policy-id <ID>

    ID kebijakan masuk dan pendaftaran untuk proyek ini. Gunakan dengan IndividualB2C autentikasi.

  • --aad-instance <INSTANCE>

    Instans Azure Active Directory untuk disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah https://login.microsoftonline.com/.

  • --client-id <ID>

    ID Klien untuk proyek ini. Gunakan dengan IndividualB2C, SingleOrg, atau Individual autentikasi dalam skenario mandiri. Nilai defaultnya adalah 33333333-3333-3333-33333333333333333.

  • --domain <DOMAIN>

    Domain untuk penyewa direktori. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah qualified.domain.name.

  • --app-id-uri <URI>

    Uri ID Aplikasi untuk API server yang ingin Anda panggil. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah api.id.uri.

  • --api-client-id <ID>

    ID Klien untuk API yang dihosting server. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah 11111111-1111-1111-11111111111111111.

  • -s|--default-scope <SCOPE>

    Cakupan API yang perlu diminta klien untuk menyediakan token akses. Gunakan dengan SingleOrg atau IndividualB2C autentikasi. Nilai defaultnya adalah user_impersonation.

  • --tenant-id <ID>

    ID TenantId direktori yang akan disambungkan. Gunakan dengan SingleOrg autentikasi. Nilai defaultnya adalah 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Memungkinkan aplikasi ini akses baca ke direktori. Hanya berlaku untuk SingleOrg autentikasi.

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • -p|--pwa

    menghasilkan Penginstalan pendukung Progresif Web Application (PWA) dan penggunaan offline.

  • --no-https

    Menonaktifkan HTTPS. Opsi ini hanya berlaku jika Individual, , atau IndividualB2C tidak digunakan untuk SingleOrg--auth.

  • -uld|--use-local-db

    Menentukan LocalDB harus digunakan alih-alih SQLite. Hanya berlaku untuk Individual atau IndividualB2C autentikasi.

  • --called-api-url <URL>

    URL API untuk dipanggil dari aplikasi web. Hanya berlaku untuk SingleOrg atau IndividualB2C autentikasi tanpa host ASP.NET Core yang ditentukan. Nilai defaultnya adalah https://graph.microsoft.com/v1.0/me.

  • --calls-graph

    Menentukan apakah aplikasi web memanggil Microsoft Graph. Hanya berlaku untuk SingleOrg autentikasi.

  • --called-api-scopes <SCOPES>

    Cakupan untuk meminta memanggil API dari aplikasi web. Hanya berlaku untuk SingleOrg atau IndividualB2C autentikasi tanpa host ASP.NET Core yang ditentukan. Default adalah user.read.

  • --kestrelHttpPort

    Nomor port yang akan digunakan untuk titik akhir HTTP di launchSettings.json.

  • --kestrelHttpsPort

    Nomor port yang digunakan untuk titik akhir HTTPS di launchSettings.json. Opsi ini tidak berlaku ketika parameter no-https digunakan (tetapi no-https diabaikan ketika pengaturan autentikasi individu atau organisasi dipilih untuk --auth).

  • --use-program-main

    Jika ditentukan, kelas dan Program metode eksplisit Main akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

Lihat juga

  • Last updated on