updates based on feedback from Charles

Author: dzsquared

articles/azure-functions/functions-bindings-azuresql-input.md

@@ -22,19 +22,28 @@ This section contains the following examples:
 * [HTTP trigger, look up ID from query string](#http-trigger-look-up-id-from-query-string-c)
 * [HTTP trigger, get multiple docs from route data](#http-trigger-get-multiple-docs-from-route-data-c)
 
-The examples refer to a simple `ToDoItem` type:
+The examples refer to a `ToDoItem` type and a corresponding database table:
 
 ```cs
 namespace AzureSQLSamples
 {
     public class ToDoItem
     {
         public string Id { get; set; }
+        public int Priority { get; set; }
         public string Description { get; set; }
     }
 }
 ```
 
+```sql
+CREATE TABLE dbo.ToDo (
+    [Id] int primary key,
+    [Priority] int null,
+    [Description] nvarchar(200) not null
+)
+```
+
 <a id="http-trigger-look-up-id-from-query-string-c"></a>
 
 ### HTTP trigger, look up ID from query string
@@ -47,6 +56,7 @@ The following example shows a [C# function](functions-dotnet-class-library.md) t
 
 ```cs
 using System.Collections.Generic;
+using System.Linq;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Azure.WebJobs;
@@ -64,17 +74,17 @@ namespace AzureSQLSamples
                 CommandType = System.Data.CommandType.Text,
                 Parameters = "@Id={Query.id}",
                 ConnectionStringSetting = "SqlConnectionString")]
-            IEnumerable<ToDoItem> todoitem)
+            IEnumerable<ToDoItem> toDoItem)
         {
-            return new OkObjectResult(todoitem);
+            return new OkObjectResult(toDoItem.FirstOrDefault());
         }
     }
 }
 ```
 
-<a id="http-trigger-get-multiple-docs-from-route-data-c"></a>
+<a id="http-trigger-get-multiple-items-from-route-data-c"></a>
 
-### HTTP trigger, get multiple docs from route data
+### HTTP trigger, get multiple items from route data
 
 The following example shows a [C# function](functions-dotnet-class-library.md) that retrieves documents returned by the query. The function is triggered by an HTTP request that uses route data to specify the value of a query parameter. That parameter is used to filter the `ToDoItem` records in the specified query.
 
@@ -91,15 +101,15 @@ namespace AzureSQLSamples
     {
         [FunctionName("GetToDoItems")]
         public static IActionResult Run(
-            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitems/{id}")]
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitems/{priority}")]
             HttpRequest req,
-            [Sql("select * from dbo.ToDo where Id > @Id",
+            [Sql("select * from dbo.ToDo where [Priority] > @Priority",
                 CommandType = System.Data.CommandType.Text,
-                Parameters = "@Id={id}",
+                Parameters = "@Priority={priority}",
                 ConnectionStringSetting = "SqlConnectionString")]
-            IEnumerable<ToDoItem> todoitem)
+            IEnumerable<ToDoItem> toDoItems)
         {
-            return new OkObjectResult(todoitem);
+            return new OkObjectResult(toDoItems);
         }
     }
 }
@@ -126,15 +136,15 @@ The attribute's constructor takes the SQL command text, the command type, parame
 Here's a `Sql` attribute example in a method signature:
 
 ```csharp
-    [FunctionName("ReturnRecords")]
+    [FunctionName("GetToDoItems")]
     public static IActionResult Run(
-            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitems/{id}")]
+            [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "gettodoitems/{priority}")]
             HttpRequest req,
-            [Sql("select * from dbo.ToDo where Id > @Id",
+            [Sql("select * from dbo.ToDo where [Priority] > @Priority",
                 CommandType = System.Data.CommandType.Text,
-                Parameters = "@Id={id}",
+                Parameters = "@Priority={priority}",
                 ConnectionStringSetting = "SqlConnectionString")]
-            IEnumerable<ToDoItem> todoitem)
+            IEnumerable<ToDoItem> toDoItems)
     {
         ...
     }

articles/azure-functions/functions-bindings-azuresql-output.md

@@ -23,19 +23,28 @@ This section contains the following examples:
 * [Http trigger, write one record](#http-trigger-write-one-record-c)
 * [Http trigger, write records using IAsyncCollector](#http-trigger-write-records-using-iasynccollector-c)
 
-The examples refer to a simple `ToDoItem` type:
+The examples refer to a `ToDoItem` type and a corresponding database table:
 
 ```cs
 namespace AzureSQLSamples
 {
     public class ToDoItem
     {
         public string Id { get; set; }
+        public int Priority { get; set; }
         public string Description { get; set; }
     }
 }
 ```
 
+```sql
+CREATE TABLE dbo.ToDo (
+    [Id] int primary key,
+    [Priority] int null,
+    [Description] nvarchar(200) not null
+)
+```
+
 <a id="http-trigger-write-one-record-c"></a>
 
 ### Http trigger, write one record
@@ -56,16 +65,16 @@ namespace AzureSQLSamples
         public static IActionResult Run(
             [HttpTrigger(AuthorizationLevel.Function, "get", Route = "addtodo")] HttpRequest req,
             ILogger log,
-            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] out ToDoItem newitem)
+            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] out ToDoItem newItem)
         {
-            newitem = new ToDoItem
+            newItem = new ToDoItem
             {
                 Id = req.Query["id"],
                 Description =req.Query["desc"]
             };
 
             log.LogInformation($"C# HTTP trigger function inserted one row");
-            return new CreatedResult($"/api/addtodo", newitem);
+            return new CreatedResult($"/api/addtodo", newItem);
         }
     }
 }
@@ -94,16 +103,16 @@ namespace AzureSQLSamples
         public static async Task<IActionResult> Run(
             [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "addtodo-asynccollector")]
             HttpRequest req,
-            [Sql("dbo.Products", ConnectionStringSetting = "SqlConnectionString")] IAsyncCollector<ToDoItem> newitems)
+            [Sql("dbo.Products", ConnectionStringSetting = "SqlConnectionString")] IAsyncCollector<ToDoItem> newItems)
         {
             string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
-            var incomingitems = JsonConvert.DeserializeObject<ToDoItem[]>(requestBody);
-            foreach (ToDoItem newitem in incomingitems)
+            var incomingItems = JsonConvert.DeserializeObject<ToDoItem[]>(requestBody);
+            foreach (ToDoItem newItem in incomingItems)
             {
-                await newitems.AddAsync(newitem);
+                await newItems.AddAsync(newItem);
             }
             // Rows are upserted here
-            await newitems.FlushAsync();
+            await newItems.FlushAsync();
 
             return new CreatedResult($"/api/addtodo-asynccollector", "done");
         }
@@ -135,7 +144,7 @@ Here's a `Sql` attribute example in a method signature:
     [FunctionName("HTTPtoSQL")]
     public static IActionResult Run(
             [HttpTrigger(AuthorizationLevel.Function, "get", Route = "addtodo")] HttpRequest req,
-            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] out ToDoItem newitem)
+            [Sql("dbo.ToDo", ConnectionStringSetting = "SqlConnectionString")] out ToDoItem newItem)
     {
         ...
     }