Merge pull request #264676 from pauljewellmsft/blob-qs-dotnet

Blob .NET quickstart cleanup

Author: prmerger-automator[bot]

articles/storage/blobs/storage-quickstart-blobs-dotnet.md

@@ -1,9 +1,9 @@
 ---
 title: "Quickstart: Azure Blob Storage library - .NET"
-description: In this quickstart, you will learn how to use the Azure Blob Storage client library for .NET to create a container and a blob in Blob (object) storage. Next, you learn how to download the blob to your local computer, and how to list all of the blobs in a container.
+description: In this quickstart, you learn how to use the Azure Blob Storage client library for .NET to create a container and a blob in Blob (object) storage. Next, you learn how to download the blob to your local computer, and how to list all of the blobs in a container.
 author: pauljewellmsft
 ms.author: pauljewell
-ms.date: 11/09/2022
+ms.date: 01/30/2024
 ms.service: azure-blob-storage
 ms.topic: quickstart
 ms.devlang: csharp
@@ -13,7 +13,9 @@ ai-usage: ai-assisted
 
 # Quickstart: Azure Blob Storage client library for .NET
 
-Get started with the Azure Blob Storage client library for .NET. Azure Blob Storage is Microsoft's object storage solution for the cloud. Follow these steps to install the package and try out example code for basic tasks. Blob storage is optimized for storing massive amounts of unstructured data.
+Get started with the Azure Blob Storage client library for .NET. Azure Blob Storage is Microsoft's object storage solution for the cloud, and is optimized for storing massive amounts of unstructured data.
+
+In this article, you follow steps to install the package and try out example code for basic tasks.
 
 [API reference documentation](/dotnet/api/azure.storage.blobs) | [Library source code](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/storage/Azure.Storage.Blobs) | [Package (NuGet)](https://www.nuget.org/packages/Azure.Storage.Blobs) | [Samples](../common/storage-samples-dotnet.md?toc=/azure/storage/blobs/toc.json#blob-samples)
 
@@ -34,7 +36,7 @@ This section walks you through preparing a project to work with the Azure Blob S
 
 ### Create the project
 
-For the steps ahead, you'll need to create a .NET console app using either the .NET CLI or Visual Studio 2022.
+Create a .NET console app using either the .NET CLI or Visual Studio 2022.
 
 ### [Visual Studio 2022](#tab/visual-studio)
 
@@ -46,7 +48,7 @@ For the steps ahead, you'll need to create a .NET console app using either the .
 
 1. For the **Project Name**, enter *BlobQuickstart*. Leave the default values for the rest of the fields and select **Next**.
 
-1. For the **Framework**, ensure .NET 6.0 is selected. Then choose **Create**. The new project will open inside the Visual Studio environment.
+1. For the **Framework**, ensure the latest installed version of .NET is selected. Then choose **Create**. The new project opens inside the Visual Studio environment.
 
 ### [.NET CLI](#tab/net-cli)
 
@@ -93,13 +95,13 @@ dotnet add package Azure.Storage.Blobs
 
 If this command to add the package fails, follow these steps:
 
-- Make sure that `nuget.org` is added as a package source. You can list the package sources using the [dotnet nuget list source](/dotnet/core/tools/dotnet-nuget-list-source#examples) command:
+- Make sure that `nuget.org` is added as a package source. You can list the package sources using the [`dotnet nuget list source`](/dotnet/core/tools/dotnet-nuget-list-source#examples) command:
 
     ```dotnetcli
     dotnet nuget list source
     ```
 
-- If you don't see `nuget.org` in the list, you can add it using the [dotnet nuget add source](/dotnet/core/tools/dotnet-nuget-add-source#examples) command:
+- If you don't see `nuget.org` in the list, you can add it using the [`dotnet nuget add source`](/dotnet/core/tools/dotnet-nuget-add-source#examples) command:
 
     ```dotnetcli
     dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org
@@ -123,8 +125,6 @@ using System.IO;
 Console.WriteLine("Hello, World!");
 ```
 
-[!INCLUDE [storage-quickstart-credential-free-include](../../../includes/storage-quickstart-credential-free-include.md)]
-
 ## Object model
 
 Azure Blob Storage is optimized for storing massive amounts of unstructured data. Unstructured data doesn't adhere to a particular data model or definition, such as text or binary data. Blob storage offers three types of resources:
@@ -145,24 +145,25 @@ Use the following .NET classes to interact with these resources:
 
 ## Code examples
 
-The sample code snippets in the following sections demonstrate how to perform basic data operations with the Azure Blob Storage client library for .NET.
+The sample code snippets in the following sections demonstrate how to perform the following tasks with the Azure Blob Storage client library for .NET:
+
+- [Authenticate to Azure and authorize access to blob data](#authenticate-to-azure-and-authorize-access-to-blob-data)
+- [Create a container](#create-a-container)
+- [Upload a blob to a container](#upload-a-blob-to-a-container)
+- [List blobs in a container](#list-blobs-in-a-container)
+- [Download a blob](#download-a-blob)
+- [Delete a container](#delete-a-container)
 
 > [!IMPORTANT]
-> Make sure you have installed the correct NuGet packages and added the necessary using statements in order for the code samples to work, as described in the [setting up](#setting-up) section.
+> Make sure you've installed the correct NuGet packages and added the necessary using statements in order for the code samples to work, as described in the [setting up](#setting-up) section.
 
-* **Azure.Identity** (if you are using the passwordless approach)
-* **Azure.Storage.Blobs**
+[!INCLUDE [storage-quickstart-credential-free-include](../../../includes/storage-quickstart-credential-free-include.md)]
 
 ### Create a container
 
-Decide on a name for the new container. The code below appends a GUID value to the container name to ensure that it is unique.
+Create a new container in your storage account by calling the [CreateBlobContainerAsync](/dotnet/api/azure.storage.blobs.blobserviceclient.createblobcontainerasync) method on the `blobServiceClient` object. In this example, the code appends a GUID value to the container name to ensure that it's unique.
 
-> [!IMPORTANT]
-> Container names must be lowercase. For more information about naming containers and blobs, see [Naming and Referencing Containers, Blobs, and Metadata](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata).
-
-You can call the [CreateBlobContainerAsync](/dotnet/api/azure.storage.blobs.blobserviceclient.createblobcontainerasync) method on the `blobServiceClient` to create a container in your storage account.
-
-Add this code to the end of the `Program.cs` class:
+Add this code to the end of the `Program.cs` file:
 
 ```csharp
 // TODO: Replace <storage-account-name> with your actual storage account name
@@ -179,8 +180,13 @@ BlobContainerClient containerClient = await blobServiceClient.CreateBlobContaine
 
 To learn more about creating a container, and to explore more code samples, see [Create a blob container with .NET](storage-blob-container-create.md).
 
+> [!IMPORTANT]
+> Container names must be lowercase. For more information about naming containers and blobs, see [Naming and Referencing Containers, Blobs, and Metadata](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata).
+
 ### Upload a blob to a container
 
+Upload a blob to a container using [UploadAsync](/dotnet/api/azure.storage.blobs.blobclient.uploadasync). The example code creates a text file in the local *data* directory to upload to the container.
+
 Add the following code to the end of the `Program.cs` class:
 
 ```csharp
@@ -198,23 +204,17 @@ BlobClient blobClient = containerClient.GetBlobClient(fileName);
 
 Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);
 
-// Upload data from the local file
+// Upload data from the local file, overwrite the blob if it already exists
 await blobClient.UploadAsync(localFilePath, true);
 ```
 
-The code snippet completes the following steps:
-
-1. Creates a text file in the local *data* directory.
-1. Gets a reference to a [BlobClient](/dotnet/api/azure.storage.blobs.blobclient) object by calling the [GetBlobClient](/dotnet/api/azure.storage.blobs.blobcontainerclient.getblobclient) method on the container from the [Create a container](#create-a-container) section.
-1. Uploads the local text file to the blob by calling the [UploadAsync](/dotnet/api/azure.storage.blobs.blobclient.uploadasync#Azure_Storage_Blobs_BlobClient_UploadAsync_System_String_System_Boolean_System_Threading_CancellationToken_) method. This method creates the blob if it doesn't already exist, and overwrites it if it does.
-
 To learn more about uploading blobs, and to explore more code samples, see [Upload a blob with .NET](storage-blob-upload.md).
 
 ### List blobs in a container
 
-List the blobs in the container by calling the [GetBlobsAsync](/dotnet/api/azure.storage.blobs.blobcontainerclient.getblobsasync) method. In this case, only one blob has been added to the container, so the listing operation returns just that one blob.
+List the blobs in the container by calling the [GetBlobsAsync](/dotnet/api/azure.storage.blobs.blobcontainerclient.getblobsasync) method.
 
-Add the following code to the end of the `Program.cs` class:
+Add the following code to the end of the `Program.cs` file:
 
 ```csharp
 Console.WriteLine("Listing blobs...");
@@ -230,9 +230,9 @@ To learn more about listing blobs, and to explore more code samples, see [List b
 
 ### Download a blob
 
-Download the previously created blob by calling the [DownloadToAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadtoasync) method. The example code adds a suffix of "DOWNLOADED" to the file name so that you can see both files in local file system.
+Download the blob we created earlier by calling the [DownloadToAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadtoasync) method. The example code appends the string "DOWNLOADED" to the file name so that you can see both files in local file system.
 
-Add the following code to the end of the `Program.cs` class:
+Add the following code to the end of the `Program.cs` file:
 
 ```csharp
 // Download the blob to a local file
@@ -250,11 +250,11 @@ To learn more about downloading blobs, and to explore more code samples, see [Do
 
 ### Delete a container
 
-The following code cleans up the resources the app created by deleting the entire container by using [DeleteAsync](/dotnet/api/azure.storage.blobs.blobcontainerclient.deleteasync). It also deletes the local files created by the app.
+The following code cleans up the resources the app created by deleting the container using [DeleteAsync](/dotnet/api/azure.storage.blobs.blobcontainerclient.deleteasync). The code example also deletes the local files created by the app.
 
-The app pauses for user input by calling `Console.ReadLine` before it deletes the blob, container, and local files. This is a good chance to verify that the resources were actually created correctly, before they are deleted.
+The app pauses for user input by calling `Console.ReadLine` before it deletes the blob, container, and local files. This is a good chance to verify that the resources were created correctly, before they're deleted.
 
-Add the following code to the end of the `Program.cs` class:
+Add the following code to the end of the `Program.cs` file:
 
 ```csharp
 // Clean up
@@ -275,7 +275,7 @@ To learn more about deleting a container, and to explore more code samples, see
 
 ## The completed code
 
-After completing these steps the code in your `Program.cs` file should now resemble the following:
+After completing these steps, the code in your `Program.cs` file should now resemble the following:
 
 ## [Passwordless (Recommended)](#tab/managed-identity)
 
@@ -424,29 +424,29 @@ dotnet build
 dotnet run
 ```
 
-The output of the app is similar to the following example:
+The output of the app is similar to the following example (GUID values omitted for readability):
 
 ```output
 Azure Blob Storage - .NET quickstart sample
 
 Uploading to Blob storage as blob:
-         https://mystorageacct.blob.core.windows.net/quickstartblobs60c70d78-8d93-43ae-954d-8322058cfd64/quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31.txt
+         https://mystorageacct.blob.core.windows.net/quickstartblobsGUID/quickstartGUID.txt
 
 Listing blobs...
-        quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31.txt
+        quickstartGUID.txt
 
 Downloading blob to
-        ./data/quickstart2fe6c5b4-7918-46cb-96f4-8c4c5cb2fd31DOWNLOADED.txt
+        ./data/quickstartGUIDDOWNLOADED.txt
 
 Press any key to begin clean up
 Deleting blob container...
 Deleting the local source and downloaded files...
 Done
 ```
 
-Before you begin the clean up process, check your *data* folder for the two files. You can open them and observe that they are identical.
+Before you begin the clean-up process, check your *data* folder for the two files. You can open them and observe that they're identical.
 
-After you've verified the files, press the **Enter** key to delete the test files and finish the demo.
+After you verify the files, press the **Enter** key to delete the test files and finish the demo.
 
 ## Next steps
 

includes/storage-quickstart-credential-free-include.md

@@ -2,19 +2,19 @@
 title: "include file"
 description: "include file"
 services: storage
-author: alexwolfmsft
+author: pauljewellmsft
 ms.service: azure-storage
 ms.topic: include
-ms.date: 09/09/2022
-ms.author: alexwolf
+ms.date: 01/30/2024
+ms.author: pauljewell
 ms.custom: include file
 ---
 
-## Authenticate to Azure and authorize access to blob data
+### Authenticate to Azure and authorize access to blob data
 
 [!INCLUDE [storage-quickstart-passwordless-auth-intro](storage-quickstart-passwordless-auth-intro.md)]
 
-## [Passwordless (Recommended)](#tab/managed-identity)
+### [Passwordless (Recommended)](#tab/managed-identity)
 
 `DefaultAzureCredential` is a class provided by the Azure Identity client library for .NET, which you can learn more about on the [DefaultAzureCredential overview](/dotnet/azure/sdk/authentication#defaultazurecredential). `DefaultAzureCredential` supports multiple authentication methods and determines which method should be used at runtime. This approach enables your app to use different authentication methods in different environments (local vs. production) without implementing environment-specific code.
 
@@ -24,11 +24,11 @@ For example, your app can authenticate using your Visual Studio sign-in credenti
 
 <a name='assign-roles-to-your-azure-ad-user-account'></a>
 
-### Assign roles to your Microsoft Entra user account
+#### Assign roles to your Microsoft Entra user account
 
 [!INCLUDE [assign-roles](assign-roles.md)]
 
-### Sign-in and connect your app code to Azure using DefaultAzureCredential
+#### Sign in and connect your app code to Azure using DefaultAzureCredential
 
 You can authorize access to data in your storage account using the following steps:
 
@@ -58,7 +58,7 @@ You can authorize access to data in your storage account using the following ste
     > [!NOTE]
     > When deployed to Azure, this same code can be used to authorize requests to Azure Storage from an application running in Azure. However, you'll need to enable managed identity on your app in Azure. Then configure your storage account to allow that managed identity to connect. For detailed instructions on configuring this connection between Azure services, see the [Auth from Azure-hosted apps](/dotnet/azure/sdk/authentication-azure-hosted-apps) tutorial.
 
-## [Connection String](#tab/connection-string)
+### [Connection String](#tab/connection-string)
 
 A connection string includes the storage account access key and uses it to authorize requests. Always be careful to never expose the keys in an unsecure location.
 
@@ -67,7 +67,7 @@ A connection string includes the storage account access key and uses it to autho
 
 [!INCLUDE [retrieve credentials](retrieve-credentials.md)]
 
-### Configure your storage connection string
+#### Configure your storage connection string
 
 After you copy the connection string, write it to a new environment variable on the local machine running the application. To set the environment variable, open a console window, and follow the instructions for your operating system. Replace `<yourconnectionstring>` with your actual connection string.
 
@@ -85,9 +85,7 @@ After you add the environment variable in Windows, you must start a new instance
 export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"
 ```
 
-### Configure the connection string
-
-The code below retrieves the connection string for the storage account from the environment variable created in the [Configure your storage connection string](#configure-your-storage-connection-string) section, and uses the connection string to construct a service client object.
+The code below retrieves the connection string for the storage account from the environment variable created earlier, and uses the connection string to construct a service client object.
 
 Add following code to the end of the `Program.cs` file: