Bagikan melalui

Templat default .NET untuk dotnet baru

  • Artikel

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

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

Templat Nama pendek Bahasa Tag Pengenalan
Aplikasi Konsol console [C#], F#, VB Umum/Konsol 1.0
Pustaka kelas classlib [C#], F#, VB Umum/Pustaka 1.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)
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
Proyek Uji MSTest mstest [C#], F#, VB Uji/MSTest 1.0
Kelas Uji MSTest mstest-class [C#], F#, VB Uji/MSTest 1.0
Proyek Pengujian NUnit 3 nunit [C#], F#, VB Test/NUnit 2.1.400
Item Uji NUnit 3 nunit-test [C#], F#, VB Test/NUnit 2.2
Proyek Pengujian xUnit xunit [C#], F#, VB Test/xUnit 1.0
Komponen Razor razorcomponent [C#] Web/ASP.NET 3.0
Halaman Razor page [C#] Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0
Blazor Aplikasi Web blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly Aplikasi Mandiri blazorwasm [C#] Web/Blazor//WebAssemblyPWA 3.1.300
ASP.NET Core Empty web [C#], F# Web/Kosong 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
Pustaka Kelas Razor razorclasslib [C#] Pustaka Kelas Web/Razor/Pustaka/Razor 2.1
ASP.NET Core Web API webapi [C#], F# Web/Web API/API/Layanan/WebAPI 1.0
ASP.NET Core API webapiaot [C#] Web/Web API/API/Layanan 8.0
pengontrol API inti ASP.NET apicontroller [C#] Web/ASP.NET 8.0
Layanan ASP.NET Core gRPC grpc [C#] Web/gRPC 3.0
file gitignore dotnet gitignore Konfigurasi 3.0
file global.json globaljson Konfigurasi 2.0
Konfigurasi NuGet nugetconfig Konfigurasi 1.0
File manifes alat lokal Dotnet tool-manifest Konfigurasi 3.0
Konfigurasi Web webconfig Konfigurasi 1.0
File Solusi sln Solusi 1.0
File Buffer Protokol proto Web/gRPC 3.0
File EditorConfig editorconfig Konfigurasi 6.0

Tabel berikut ini memperlihatkan templat yang telah dihentikan dan tidak lagi diinstal sebelumnya dengan .NET SDK. Klik tautan nama pendek untuk melihat opsi templat tertentu.

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
BlazorWebAssembly Aplikasi Kosong blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

Opsi templat

Setiap templat mungkin memiliki opsi tambahan yang tersedia. Untuk memperlihatkan opsi tambahan yang tersedia untuk templat, gunakan --help opsi dengan argumen nama templat, misalnya: dotnet new console --help. Jika templat mendukung beberapa bahasa, perintah ini 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 dikirim dengan .NET SDK memiliki opsi tambahan berikut:

console

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Tersedia sejak SDK .NET Core 3.0.

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

    Versi SDK Nilai default
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    3.1 netcoreapp3.1

    Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 7 SDK yang terinstal, maka satu-satunya nilai yang tersedia adalah --framework net7.0. Jika Anda menginstal .NET 6 SDK, nilainya net6.0 akan tersedia untuk --framework. Jika Anda menginstal .NET Core 3.1 SDK, netcoreapp3.1 tersedia, dan sebagainya. Jadi dengan menentukan Anda dapat menargetkan --framework netcoreapp3.1 .NET Core 3.1 bahkan saat berjalan dotnet new di .NET 6 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#. Tersedia sejak .NET Core 2.2 SDK.

    Untuk daftar versi C# default, lihat Default.

  • --no-restore

    Jika ditentukan, tidak menjalankan pemulihan implisit selama pembuatan proyek. Tersedia sejak .NET Core 2.2 SDK.

  • --use-program-main

    Jika ditentukan, kelas dan Main metode eksplisit Program 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: net8.0, , net7.0atau net6.0 untuk membuat Pustaka Kelas .NET, atau netstandard2.1 netstandard2.0 untuk membuat Pustaka Kelas Standar .NET. Nilai default untuk .NET SDK 8.0.x adalah 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.

  • --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#. Tersedia sejak .NET Core 2.2 SDK.

    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 8 SDK, nilai defaultnya adalah net8.0. Tersedia sejak .NET Core 3.1 SDK.

  • --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 8 SDK adalah net8.0. Tersedia sejak .NET Core 3.1 SDK.

    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 Main metode eksplisit Program 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. Opsi tersedia sejak .NET Core 3.0 SDK.

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

    Versi SDK Nilai default
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 6 SDK yang terinstal, maka satu-satunya nilai yang tersedia adalah --framework net6.0. Jika Anda menginstal .NET 5 SDK, nilainya net5.0 akan tersedia untuk --framework. Jika Anda menginstal .NET Core 3.1 SDK, netcoreapp3.1 tersedia, dan sebagainya. Jadi dengan menentukan Anda dapat menargetkan --framework netcoreapp3.1 .NET Core 3.1 bahkan saat berjalan dotnet new di .NET 6 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 - MSTest Runner (yaitu Microsoft.Testing.Platform).

  • --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 MSTest Runner. 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. Opsi tersedia sejak .NET Core 3.0 SDK.

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

    Versi SDK Nilai default
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 6 SDK yang terinstal, maka satu-satunya nilai yang tersedia adalah --framework net6.0. Jika Anda menginstal .NET 5 SDK, nilainya net5.0 akan tersedia untuk --framework. Jika Anda menginstal .NET Core 3.1 SDK, netcoreapp3.1 tersedia, dan sebagainya. Jadi dengan menentukan Anda dapat menargetkan --framework netcoreapp3.1 .NET Core 3.1 bahkan saat berjalan dotnet new di .NET 6 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
    9.0 net9.0
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

Kemampuan untuk membuat proyek untuk TFM sebelumnya tergantung pada memiliki versi SDK yang diinstal. Misalnya, jika Anda hanya memiliki .NET 6 SDK yang terinstal, maka satu-satunya nilai yang tersedia adalah --framework net6.0. Jika Anda menginstal .NET 5 SDK, nilainya net5.0 akan tersedia untuk --framework. Jika Anda menginstal .NET Core 3.1 SDK, netcoreapp3.1 tersedia, dan sebagainya. Jadi dengan menentukan Anda dapat menargetkan --framework netcoreapp3.1 .NET Core 3.1 bahkan saat berjalan dotnet new di .NET 6 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.

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 Main metode eksplisit Program akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

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 Main metode eksplisit Program dihasilkan alih-alih pernyataan tingkat atas.

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
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

    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 SingleOrg tidak digunakan untuk --authIndividualB2C.

  • -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 Main metode eksplisit Program akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

web

  • --exclude-launch-settings

    Mengecualikan launchSettings.json dari templat yang dihasilkan.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Opsi tidak tersedia di .NET Core 2.2 SDK.

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

    Versi SDK Nilai default
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    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 Main metode eksplisit Program 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. Opsi tersedia sejak .NET Core 3.0 SDK.

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

    Versi SDK Nilai default
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.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. Opsi tidak tersedia di .NET Core 2.2 dan 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Menentukan apakah proyek dikonfigurasi untuk menggunakan kompilasi runtime Razor di build Debug. Opsi tersedia sejak .NET Core 3.1.201 SDK.

  • --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 Main metode eksplisit Program akan digunakan alih-alih pernyataan tingkat atas. Tersedia sejak .NET SDK 6.0.300. Nilai default: false.

angular, react

Dihentikan sejak .NET 8 SDK.

  • -au|--auth <AUTHENTICATION_TYPE>

    Jenis autentikasi yang akan digunakan. Tersedia sejak SDK .NET Core 3.0.

    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. Tersedia sejak SDK .NET Core 3.0.

  • -f|--framework <FRAMEWORK>

    Menentukan kerangka kerja yang akan ditargetkan. Opsi tidak tersedia di .NET Core 2.2 SDK.

    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
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.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 Main metode eksplisit Program 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. Tersedia sejak SDK .NET Core 3.0.

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
    8.0 net8.0

  • --no-restore

    Tidak menjalankan pemulihan implisit selama pembuatan proyek.

  • --use-program-main

    Jika ditentukan, kelas dan Main metode eksplisit Program 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). AddSwaggerGen, UseSwagger, dan UseSwaggerUI 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. Opsi tidak tersedia di .NET Core 2.2 SDK.

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

    Versi SDK Nilai default
    8.0 net8.0
    7,0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.1

    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 Main metode eksplisit Program 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.

editorconfig

Membuat file .editorconfig untuk mengonfigurasi preferensi gaya kode.

  • --empty

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

Lihat juga