update WebApi to .NET 9 (without Swagger) (#34746)

* Update .NET version references in first-web-api.md to 9.0

* update sample to target .NET 9.0

* rename example to _SwaggerExample

* add OpenAPI example (no swagger)

* update WebApi to .NET 9 (without swagger)

* remove unused example

* review fixes

* apply changes from #34676

* include IsDevelopment codeblock to match the text description

* VS new project settings moved to order they appear in dialog

* Right-click or Command-click on project in VSC

Control-click on a project in VSC on windows does not work, must be Right-click for Windows and Control-click on macOS for VSC.

* Specifying the DTO file and location in the instruction

* Apply suggestions from code review

* Update author names in web API tutorial

* Add comment block in first-web-api tutorial

* Apply suggestions from code review

revert

* Update aspnetcore/tutorials/first-web-api.md

* remove unused file 'create-new-project'

---------

Co-authored-by: Wade Pickett <[email protected]>
Co-authored-by: Rick Anderson <[email protected]>

Author: 3 people

aspnetcore/tutorials/first-web-api.md

@@ -2,108 +2,111 @@
 using Microsoft.EntityFrameworkCore;
 using TodoApi.Models;
 
-namespace TodoApi.Controllers
+namespace TodoApi.Controllers;
+
+// <snippet_Route>
+[Route("api/[controller]")]
+[ApiController]
+public class TodoItemsController : ControllerBase
+// </snippet_Route>
 {
-    [Route("api/[controller]")]
-    [ApiController]
-    public class TodoItemsController : ControllerBase
+    private readonly TodoContext _context;
+
+    public TodoItemsController(TodoContext context)
     {
-        private readonly TodoContext _context;
+        _context = context;
+    }
 
-        public TodoItemsController(TodoContext context)
-        {
-            _context = context;
-        }
+    // GET: api/TodoItems
+    [HttpGet]
+    public async Task<ActionResult<IEnumerable<TodoItem>>> GetTodoItems()
+    {
+        return await _context.TodoItems.ToListAsync();
+    }
+
+    // GET: api/TodoItems/5
+    // <snippet_GetByID>
+    [HttpGet("{id}")]
+    public async Task<ActionResult<TodoItem>> GetTodoItem(long id)
+    {
+        var todoItem = await _context.TodoItems.FindAsync(id);
 
-        // GET: api/TodoItems
-        [HttpGet]
-        public async Task<ActionResult<IEnumerable<TodoItem>>> GetTodoItems()
+        if (todoItem == null)
         {
-            return await _context.TodoItems.ToListAsync();
+            return NotFound();
         }
 
-        // GET: api/TodoItems/5
-        // <snippet_GetByID>
-        [HttpGet("{id}")]
-        public async Task<ActionResult<TodoItem>> GetTodoItem(long id)
+        return todoItem;
+    }
+    // </snippet_GetByID>
+
+    // PUT: api/TodoItems/5
+    // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
+    // <snippet_Update>
+    [HttpPut("{id}")]
+    public async Task<IActionResult> PutTodoItem(long id, TodoItem todoItem)
+    {
+        if (id != todoItem.Id)
         {
-            var todoItem = await _context.TodoItems.FindAsync(id);
+            return BadRequest();
+        }
 
-            if (todoItem == null)
-            {
-                return NotFound();
-            }
+        _context.Entry(todoItem).State = EntityState.Modified;
 
-            return todoItem;
+        try
+        {
+            await _context.SaveChangesAsync();
         }
-        // </snippet_GetByID>
-
-        // PUT: api/TodoItems/5
-        // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
-        // <snippet_Update>
-        [HttpPut("{id}")]
-        public async Task<IActionResult> PutTodoItem(long id, TodoItem todoItem)
+        catch (DbUpdateConcurrencyException)
         {
-            if (id != todoItem.Id)
+            if (!TodoItemExists(id))
             {
-                return BadRequest();
-            }
-
-            _context.Entry(todoItem).State = EntityState.Modified;
-
-            try
-            {
-                await _context.SaveChangesAsync();
+                return NotFound();
             }
-            catch (DbUpdateConcurrencyException)
+            else
             {
-                if (!TodoItemExists(id))
-                {
-                    return NotFound();
-                }
-                else
-                {
-                    throw;
-                }
+                throw;
             }
-
-            return NoContent();
         }
-        // </snippet_Update>
 
-        // POST: api/TodoItems
-        // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
-        // <snippet_Create>
-        [HttpPost]
-        public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem todoItem)
-        {
-            _context.TodoItems.Add(todoItem);
-            await _context.SaveChangesAsync();
+        return NoContent();
+    }
+    // </snippet_Update>
 
-            //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
-            return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
-        }
-        // </snippet_Create>
+    // POST: api/TodoItems
+    // To protect from overposting attacks, see https://go.microsoft.com/fwlink/?linkid=2123754
+    // <snippet_Create>
+    [HttpPost]
+    public async Task<ActionResult<TodoItem>> PostTodoItem(TodoItem todoItem)
+    {
+        _context.TodoItems.Add(todoItem);
+        await _context.SaveChangesAsync();
 
-        // DELETE: api/TodoItems/5
-        [HttpDelete("{id}")]
-        public async Task<IActionResult> DeleteTodoItem(long id)
+        //    return CreatedAtAction("GetTodoItem", new { id = todoItem.Id }, todoItem);
+        return CreatedAtAction(nameof(GetTodoItem), new { id = todoItem.Id }, todoItem);
+    }
+    // </snippet_Create>
+
+    // DELETE: api/TodoItems/5
+    // <snippet_Delete>
+    [HttpDelete("{id}")]
+    public async Task<IActionResult> DeleteTodoItem(long id)
+    {
+        var todoItem = await _context.TodoItems.FindAsync(id);
+        if (todoItem == null)
         {
-            var todoItem = await _context.TodoItems.FindAsync(id);
-            if (todoItem == null)
-            {
-                return NotFound();
-            }
+            return NotFound();
+        }
 
-            _context.TodoItems.Remove(todoItem);
-            await _context.SaveChangesAsync();
+        _context.TodoItems.Remove(todoItem);
+        await _context.SaveChangesAsync();
 
-            return NoContent();
-        }
+        return NoContent();
+    }
+    // </snippet_Delete>
 
-        private bool TodoItemExists(long id)
-        {
-            return _context.TodoItems.Any(e => e.Id == id);
-        }
+    private bool TodoItemExists(long id)
+    {
+        return _context.TodoItems.Any(e => e.Id == id);
     }
-}
+}

aspnetcore/tutorials/first-web-api/_static/9/generate-request-vs17.13.0.png

@@ -1,33 +1,32 @@
 using Microsoft.AspNetCore.Mvc;
 
-namespace TodoApi.Controllers
+namespace TodoApi.Controllers;
+
+[ApiController]
+[Route("[controller]")]
+public class WeatherForecastController : ControllerBase
 {
-    [ApiController]
-    [Route("[controller]")]
-    public class WeatherForecastController : ControllerBase
+    private static readonly string[] Summaries = new[]
     {
-        private static readonly string[] Summaries = new[]
-        {
-            "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
-        };
+        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
+    };
 
-        private readonly ILogger<WeatherForecastController> _logger;
+    private readonly ILogger<WeatherForecastController> _logger;
 
-        public WeatherForecastController(ILogger<WeatherForecastController> logger)
-        {
-            _logger = logger;
-        }
+    public WeatherForecastController(ILogger<WeatherForecastController> logger)
+    {
+        _logger = logger;
+    }
 
-        [HttpGet(Name = "GetWeatherForecast")]
-        public IEnumerable<WeatherForecast> Get()
-        {
-            return Enumerable.Range(1, 5).Select(index => new WeatherForecast
+    [HttpGet(Name = "GetWeatherForecast")]
+    public IEnumerable<WeatherForecast> Get()
+    {
+        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
             {
                 Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)),
                 TemperatureC = Random.Shared.Next(-20, 55),
                 Summary = Summaries[Random.Shared.Next(Summaries.Length)]
             })
             .ToArray();
-        }
     }
-}
+}