dotnet aspnet-codegenerator
Autor: Rick Anderson
dotnet aspnet-codegenerator — Uruchamia aparat szkieletów ASP.NET Core. dotnet aspnet-codegenerator Program jest wymagany tylko do tworzenia szkieletów z wiersza polecenia. Nie jest konieczne używanie szkieletu w programie Visual Studio.
Instalowanie i aktualizowanie modułu aspnet-codegenerator
Zainstaluj zestaw .NET SDK.
dotnet aspnet-codegeneratorto narzędzie globalne, które należy zainstalować. Następujące polecenie instaluje najnowszą stabilną wersję dotnet aspnet-codegenerator narzędzia:
dotnet tool install -g dotnet-aspnet-codegenerator
Uwaga
Domyślnie architektura plików binarnych platformy .NET do zainstalowania reprezentuje obecnie uruchomioną architekturę systemu operacyjnego. Aby określić inną architekturę systemu operacyjnego, zobacz dotnet tool install, --arch option(Instalacja narzędzia dotnet). Aby uzyskać więcej informacji, zobacz problem z usługą GitHub dotnet/AspNetCore.Docs #29262.
Następujące polecenie aktualizuje dotnet aspnet-codegenerator najnowszą stabilną wersję dostępną z zainstalowanych zestawów SDK platformy .NET Core:
dotnet tool update -g dotnet-aspnet-codegenerator
Odinstalowywanie modułu aspnet-codegenerator
Może być konieczne odinstalowanie narzędzia aspnet-codegenerator , aby rozwiązać problemy. Jeśli na przykład zainstalowano wersję zapoznawcza programu aspnet-codegenerator, odinstaluj ją przed zainstalowaniem wydanej wersji.
Następujące polecenia odinstalowują dotnet aspnet-codegenerator narzędzie i instalują najnowszą stabilną wersję:
dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator
Streszczenie
dotnet aspnet-codegenerator [arguments] [-p|--project] [-n|--nuget-package-dir] [-c|--configuration] [-tfm|--target-framework] [-b|--build-base-path] [--no-build]
dotnet aspnet-codegenerator [-h|--help]
opis
Globalne dotnet aspnet-codegenerator polecenie uruchamia generator kodu ASP.NET Core i aparat tworzenia szkieletów.
Argumenty
generator
Generator kodu do uruchomienia. Dostępne są następujące generatory:
| Generator | Operacja |
|---|---|
| Obszar | Szkielety obszaru |
| kontroler | Szkielety kontrolera |
| tożsamość | Rusztowania Identity |
| razorpage | Strony szkieletów Razor |
| wyświetl | Szkielety widoku |
Opcje
-n|--nuget-package-dir
Określa katalog pakietów NuGet.
-c|--configuration {Debug|Release}
Definiuje konfigurację kompilacji. Wartość domyślna to Debug.
-tfm|--target-framework
Platforma docelowa do użycia. Na przykład net46.
-b|--build-base-path
Ścieżka podstawowa kompilacji.
-h|--help
Wyświetla krótką pomoc dla polecenia .
--no-build
Nie kompiluje projektu przed uruchomieniem. Ponadto niejawnie ustawia flagę --no-restore .
-p|--project <PATH>
Określa ścieżkę pliku projektu do uruchomienia (nazwa folderu lub pełna ścieżka). Jeśli nie zostanie określony, zostanie on domyślnie określony w bieżącym katalogu.
Opcje generatora
W poniższych sekcjach opisano opcje dostępne dla obsługiwanych generatorów:
- Obszar
- Kontroler
- Identity
- RazorStrona
- Wyświetlanie
Opcje obszaru
To narzędzie jest przeznaczone dla projektów internetowych ASP.NET Core z kontrolerami i widokami. Nie jest ona przeznaczona dla Razor aplikacji Pages.
Użycie: dotnet aspnet-codegenerator area AreaNameToGenerate
Poprzednie polecenie generuje następujące foldery:
- Obszary
- AreaNameToGenerate
- Kontrolery
- Data
- Modele
- Widoki
- AreaNameToGenerate
Opcje kontrolera
W poniższej tabeli wymieniono opcje dla aspnet-codegeneratorelementów i controllerview:razorpage
| Opcja | Opis |
|---|---|
| --model lub -m | Klasa modelu do użycia. |
| --dataContext lub -dc | Klasa DbContext do użycia lub nazwa klasy do wygenerowania. |
| --bootstrapVersion lub -b | Określa wersję bootstrap. Prawidłowe wartości to 3 i 4. Wartość domyślna to 4. W razie potrzeby i nie jest obecny, zostanie utworzony katalog wwwroot zawierający pliki bootstrap określonej wersji. |
| --referenceScriptLibraries lub -scripts | Odwołania do bibliotek skryptów w wygenerowanych widokach. Dodaje _ValidationScriptsPartial do pozycji Edytuj i Utwórz strony. |
| --layout lub -l | Strona układu niestandardowego do użycia. |
| --useDefaultLayout lub -udl | Użyj domyślnego układu widoków. |
| --force lub -f | Zastąp istniejące pliki. |
| --relativeFolderPath lub -outDir | Określ względną ścieżkę folderu wyjściowego z projektu, w którym plik musi zostać wygenerowany, jeśli nie zostanie określony, plik zostanie wygenerowany w folderze projektu |
| --useSqlite lub -sqlite | Flaga określająca, czy DbContext należy używać programu SQLite zamiast programu SQL Server. |
W poniższej tabeli wymieniono opcje unikatowe dla aspnet-codegenerator controllerelementu :
| Opcja | Opis |
|---|---|
| --controllerName lub -name | Nazwa kontrolera. |
| --useAsyncActions lub -async | Generowanie akcji kontrolera asynchronicznego. |
| --noViews lub -nv | Nie generuje żadnych widoków. |
| --restWithNoViews lub -api | Generowanie kontrolera przy użyciu REST interfejsu API stylu. noViews przyjmuje się założenie, że wszystkie opcje powiązane z widokiem są ignorowane. |
| --readWriteActions lub -actions | Generowanie kontrolera za pomocą akcji odczytu/zapisu bez modelu. |
Użyj przełącznika -h , aby uzyskać pomoc dotyczącą aspnet-codegenerator controller polecenia:
dotnet aspnet-codegenerator controller -h
Zobacz Tworzenie szkieletu modelu filmu, aby zapoznać się z przykładem elementu dotnet aspnet-codegenerator controller.
RazorStrona
Razor Strony można oddzielnie szkieletować, określając nazwę nowej strony i szablon do użycia. Obsługiwane szablony to:
EmptyCreateEditDeleteDetailsList
Na przykład następujące polecenie używa szablonu Edytuj do generowania MyEdit.cshtml i MyEdit.cshtml.cs:
dotnet aspnet-codegenerator razorpage MyEdit Edit -m Movie -dc RazorPagesMovieContext -outDir Pages/Movies
Zazwyczaj szablon i wygenerowana nazwa pliku nie są określone, a tworzone są następujące szablony:
CreateEditDeleteDetailsList
W poniższej tabeli wymieniono opcje dla aspnet-codegeneratorelementów i controllerview:razorpage
| Opcja | Opis |
|---|---|
| --model lub -m | Klasa modelu do użycia. |
| --dataContext lub -dc | Klasa DbContext do użycia lub nazwa klasy do wygenerowania. |
| --bootstrapVersion lub -b | Określa wersję bootstrap. Prawidłowe wartości to 3 i 4. Wartość domyślna to 4. W razie potrzeby i nie jest obecny, zostanie utworzony katalog wwwroot zawierający pliki bootstrap określonej wersji. |
| --referenceScriptLibraries lub -scripts | Odwołania do bibliotek skryptów w wygenerowanych widokach. Dodaje _ValidationScriptsPartial do pozycji Edytuj i Utwórz strony. |
| --layout lub -l | Strona układu niestandardowego do użycia. |
| --useDefaultLayout lub -udl | Użyj domyślnego układu widoków. |
| --force lub -f | Zastąp istniejące pliki. |
| --relativeFolderPath lub -outDir | Określ względną ścieżkę folderu wyjściowego z projektu, w którym plik musi zostać wygenerowany, jeśli nie zostanie określony, plik zostanie wygenerowany w folderze projektu |
| --useSqlite lub -sqlite | Flaga określająca, czy DbContext należy używać programu SQLite zamiast programu SQL Server. |
W poniższej tabeli wymieniono opcje unikatowe dla aspnet-codegenerator razorpageelementu :
| Opcja | Opis |
|---|---|
| --namespaceName lub -namespace | Nazwa przestrzeni nazw, która ma być używana dla wygenerowanego modelu PageModel |
| --partialView lub -partial | Generowanie widoku częściowego. Opcje układu -l i -udl są ignorowane, jeśli jest określony. |
| --noPageModel lub -npm | Przełącz się, aby nie wygenerować klasy PageModel dla pustego szablonu |
Użyj przełącznika -h , aby uzyskać pomoc dotyczącą aspnet-codegenerator razorpage polecenia:
dotnet aspnet-codegenerator razorpage -h
Zobacz Tworzenie szkieletu modelu filmu, aby zapoznać się z przykładem elementu dotnet aspnet-codegenerator razorpage.
Wyświetlanie
Widoki mogą być oddzielnie szkieletowe, określając nazwę widoku i szablon do użycia. Obsługiwane szablony to:
EmptyCreateEditDeleteDetailsList
Na przykład następujące polecenie używa szablonu Edytuj do wygenerowania MyEdit.cshtmlelementu :
dotnet aspnet-codegenerator view MyEdit Edit -m Movie -dc MovieContext -outDir Views/Movies
W poniższej tabeli wymieniono opcje dla aspnet-codegeneratorelementów i controllerview:razorpage
| Opcja | Opis |
|---|---|
| --model lub -m | Klasa modelu do użycia. |
| --dataContext lub -dc | Klasa DbContext do użycia lub nazwa klasy do wygenerowania. |
| --bootstrapVersion lub -b | Określa wersję bootstrap. Prawidłowe wartości to 3 i 4. Wartość domyślna to 4. W razie potrzeby i nie jest obecny, zostanie utworzony katalog wwwroot zawierający pliki bootstrap określonej wersji. |
| --referenceScriptLibraries lub -scripts | Odwołania do bibliotek skryptów w wygenerowanych widokach. Dodaje _ValidationScriptsPartial do pozycji Edytuj i Utwórz strony. |
| --layout lub -l | Strona układu niestandardowego do użycia. |
| --useDefaultLayout lub -udl | Użyj domyślnego układu widoków. |
| --force lub -f | Zastąp istniejące pliki. |
| --relativeFolderPath lub -outDir | Określ względną ścieżkę folderu wyjściowego z projektu, w którym plik musi zostać wygenerowany, jeśli nie zostanie określony, plik zostanie wygenerowany w folderze projektu |
| --useSqlite lub -sqlite | Flaga określająca, czy DbContext należy używać programu SQLite zamiast programu SQL Server. |
W poniższej tabeli wymieniono opcje unikatowe dla aspnet-codegenerator viewelementu :
| Opcja | Opis |
|---|---|
| --controllerNamespace lub -namespace | Określ nazwę przestrzeni nazw, która ma być używana dla wygenerowanego kontrolera |
| --partialView lub -partial | Generowanie widoku częściowego, inne opcje układu (-l i -udl) są ignorowane, jeśli określono ten widok |
Użyj przełącznika -h , aby uzyskać pomoc dotyczącą aspnet-codegenerator view polecenia:
dotnet aspnet-codegenerator view -h
Identity
Zobacz Szkielet Identity
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla