Merge pull request #235413 from pauljewellmsft/pauljewell-upload-download

Update dev guide upload/download articles

Author: Court72

articles/storage/blobs/storage-blob-download-java.md

@@ -16,27 +16,40 @@ ms.custom: devx-track-java, devguide-java
 
 # Download a blob with Java
 
-This article shows how to download a blob using the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). You can download blob data to various destinations, including a local file path, stream, or text string. You can also open a blob stream and read from it.
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an upload operation. To learn more, see the authorization guidance for the following REST API operation:
+    - [Get Blob](/rest/api/storageservices/get-blob#authorization)
+- The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Java](storage-blob-java-get-started.md#set-up-your-project).
+
+## Download a blob
+
+You can use any of the following methods to download a blob:
 
 - [downloadContent](/java/api/com.azure.storage.blob.specialized.blobclientbase)
 - [downloadStream](/java/api/com.azure.storage.blob.specialized.blobclientbase)
 - [downloadToFile](/java/api/com.azure.storage.blob.specialized.blobclientbase)
 
 ## Download to a file path
 
-The following example downloads a blob by using a file path:
+The following example downloads a blob to a local file path:
 
 :::code language="java" source="~/azure-storage-snippets/blobs/howto/Java/blob-devguide/blob-devguide-blobs/src/main/java/com/blobs/devguide/blobs/BlobDownload.java" id="Snippet_DownloadBLobFile":::
 
 ## Download to a stream
 
-The following example downloads a blob to an `OutputStream`:
+The following example downloads a blob to an `OutputStream` object:
 
 :::code language="java" source="~/azure-storage-snippets/blobs/howto/Java/blob-devguide/blob-devguide-blobs/src/main/java/com/blobs/devguide/blobs/BlobDownload.java" id="Snippet_DownloadBLobStream":::
 
 ## Download to a string
 
-The following example downloads a blob to a `String` object. This example assumes that the blob is a text file.
+The following example assumes that the blob is a text file, and downloads the blob to a `String` object:
 
 :::code language="java" source="~/azure-storage-snippets/blobs/howto/Java/blob-devguide/blob-devguide-blobs/src/main/java/com/blobs/devguide/blobs/BlobDownload.java" id="Snippet_DownloadBLobText":::
 

articles/storage/blobs/storage-blob-download-javascript.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 11/30/2022
+ms.date: 04/21/2023
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
@@ -16,14 +16,24 @@ ms.custom: devx-track-js, devguide-js
 
 # Download a blob with JavaScript
 
-This article shows how to download a blob using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). You can download blob data to various destinations, including a local file path, stream, or text string.
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an upload operation. To learn more, see the authorization guidance for the following REST API operation:
+    - [Get Blob](/rest/api/storageservices/get-blob#authorization)
+- The package **@azure/storage-blob** installed to your project directory. To learn more about setting up your project, see [Get started with Azure Blob Storage and JavaScript](storage-blob-javascript-get-started.md).
+
+## Download a blob
+
+You can use any of the following methods to download a blob: 
 
 - [BlobClient.download](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-download)
 - [BlobClient.downloadToBuffer](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtobuffer-1) (only available in Node.js runtime)
 - [BlobClient.downloadToFile](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtofile) (only available in Node.js runtime)
-
-> [!NOTE]
-> The examples in this article assume that you've created a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) object by using the guidance in the [Get started with Azure Blob Storage and JavaScript](storage-blob-javascript-get-started.md) article. Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. To learn how to create a container, see [Create a container in Azure Storage with JavaScript](storage-blob-container-create.md). 
 
 ## Download to a file path
 

articles/storage/blobs/storage-blob-download-python.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 01/24/2023
+ms.date: 04/21/2023
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
@@ -16,7 +16,20 @@ ms.custom: devx-track-python, devguide-python
 
 # Download a blob with Python
 
-This article shows how to download a blob using the [Azure Storage client library for Python](/python/api/overview/azure/storage). You can download a blob by using the following method:
+This article shows how to download a blob using the [Azure Storage client library for Python](/python/api/overview/azure/storage). You can download blob data to various destinations, including a local file path, stream, or text string. You can also open a blob stream and read from it.
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an upload operation. To learn more, see the authorization guidance for the following REST API operation:
+    - [Get Blob](/rest/api/storageservices/get-blob#authorization)
+- The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Java](storage-blob-java-get-started.md#set-up-your-project).
+
+## Download a blob
+
+You can use the following method to download a blob:
 
 - [BlobClient.download_blob](/python/api/azure-storage-blob/azure.storage.blob.blobclient#azure-storage-blob-blobclient-download-blob)
 

articles/storage/blobs/storage-blob-download-typescript.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 03/21/2023
+ms.date: 04/21/2023
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
@@ -16,14 +16,24 @@ ms.custom: devx-track-ts, devguide-ts
 
 # Download a blob with TypeScript
 
-This article shows how to download a blob using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). You can download blob data to various destinations, including a local file path, stream, or text string.
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an upload operation. To learn more, see the authorization guidance for the following REST API operation:
+    - [Get Blob](/rest/api/storageservices/get-blob#authorization)
+- The package **@azure/storage-blob** installed to your project directory. To learn more about setting up your project, see [Get started with Azure Blob Storage and TypeScript](storage-blob-typescript-get-started.md).
+
+## Download a blob
+
+You can use any of the following methods to download a blob:
 
 - [BlobClient.download](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-download)
 - [BlobClient.downloadToBuffer](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtobuffer-1) (only available in Node.js runtime)
 - [BlobClient.downloadToFile](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtofile) (only available in Node.js runtime)
-
-> [!NOTE]
-> The examples in this article assume that you've created a [BlobServiceClient](/javascript/api/@azure/storage-blob/blobserviceclient) object by using the guidance in the [Get started with Azure Blob Storage and TypeScript](storage-blob-typescript-get-started.md) article. Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. To learn how to create a container, see [Create a container in Azure Storage with TypeScript](storage-blob-container-create-typescript.md). 
 
 ## Download to a file path
 

articles/storage/blobs/storage-blob-download.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 03/28/2022
+ms.date: 04/21/2023
 ms.service: storage
 ms.subservice: blobs
 ms.topic: how-to
@@ -16,91 +16,54 @@ ms.custom: devx-track-csharp, devguide-csharp
 
 # Download a blob with .NET
 
-This article shows how to download a blob using the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). You can download blob data to various destinations, including a local file path, stream, or text string. You can also open a blob stream and read from it.
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an upload operation. To learn more, see the authorization guidance for the following REST API operation:
+    - [Get Blob](/rest/api/storageservices/get-blob#authorization)
+- The package **Azure.Storage.Blobs** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and .NET](storage-blob-dotnet-get-started.md#set-up-your-project).
+
+## Download a blob
+
+You can use any of the following methods to download a blob:
 
 - [DownloadTo](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadto)
 - [DownloadToAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadtoasync)
 - [DownloadContent](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadcontent)
 - [DownloadContentAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadcontentasync)
 
-You can also open a stream to read from a blob. The stream will only download the blob as the stream is read from. Use either of the following methods:
+You can also open a stream to read from a blob. The stream only downloads the blob as the stream is read from. You can use either of the following methods:
 
 - [OpenRead](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.openread)
 - [OpenReadAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.openreadasync)
-
-> [!NOTE]
-> The examples in this article assume that you've created a [BlobServiceClient](/dotnet/api/azure.storage.blobs.blobserviceclient) object by using the guidance in the [Get started with Azure Blob Storage and .NET](storage-blob-dotnet-get-started.md) article.  
 
 ## Download to a file path
 
-The following example downloads a blob by using a file path. If the specified directory does not exist, handle the exception and notify the user.
-
-```csharp
-public static async Task DownloadBlob(BlobClient blobClient, string localFilePath)
-{
-    try
-    {
-        await blobClient.DownloadToAsync(localFilePath);
-    }
-    catch (DirectoryNotFoundException ex)
-    {
-        // Let the user know that the directory does not exist
-        Console.WriteLine($"Directory not found: {ex.Message}");
-    }
-}
-```
-
-If the file already exists at `localFilePath`, it will be overwritten by default during subsequent downloads.
+The following example downloads a blob to a local file path. If the specified directory doesn't exist, the code throws a [DirectoryNotFoundException](/dotnet/api/system.io.directorynotfoundexception). If the file already exists at `localFilePath`, it's overwritten by default during subsequent downloads.
+
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/DownloadBlob.cs" id="Snippet_DownloadBlobToFile":::
 
 ## Download to a stream
 
-The following example downloads a blob by creating a [Stream](/dotnet/api/system.io.stream) object and then downloads to that stream. If the specified directory does not exist, handle the exception and notify the user.
-
-```csharp
-public static async Task DownloadToStream(BlobClient blobClient, string localFilePath)
-{
-    try
-    {
-        FileStream fileStream = File.OpenWrite(localFilePath);
-        await blobClient.DownloadToAsync(fileStream);
-        fileStream.Close();
-    }
-    catch (DirectoryNotFoundException ex)
-    {
-        // Let the user know that the directory does not exist
-        Console.WriteLine($"Directory not found: {ex.Message}");
-    }
-}
-```
+The following example downloads a blob by creating a [Stream](/dotnet/api/system.io.stream) object and then downloads to that stream. If the specified directory doesn't exist, the code throws a [DirectoryNotFoundException](/dotnet/api/system.io.directorynotfoundexception).
+
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/DownloadBlob.cs" id="Snippet_DownloadBlobToStream":::
 
 ## Download to a string
 
-The following example downloads a blob to a string. This example assumes that the blob is a text file.  
+The following example assumes that the blob is a text file, and downloads the blob to a string: 
 
-```csharp
-public static async Task DownloadToText(BlobClient blobClient)
-{
-    BlobDownloadResult downloadResult = await blobClient.DownloadContentAsync();
-    string downloadedData = downloadResult.Content.ToString();
-    Console.WriteLine("Downloaded data:", downloadedData);
-}
-```
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/DownloadBlob.cs" id="Snippet_DownloadBlobToString":::
 
 ## Download from a stream
 
-The following example downloads a blob by reading from a stream. 
-
-```csharp
-public static async Task DownloadfromStream(BlobClient blobClient, string localFilePath)
-{
-    using (var stream = await blobClient.OpenReadAsync())
-    {
-        FileStream fileStream = File.OpenWrite(localFilePath);
-        await stream.CopyToAsync(fileStream);
-    }
-}
+The following example downloads a blob by reading from a stream:
 
-```
+:::code language="csharp" source="~/azure-storage-snippets/blobs/howto/dotnet/BlobDevGuideBlobs/DownloadBlob.cs" id="Snippet_DownloadBlobFromStream":::
 
 ## Resources
 
@@ -112,4 +75,12 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
 
 - [Get Blob](/rest/api/storageservices/get-blob) (REST API)
 
+### Code samples
+
+- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/DownloadBlob.cs)
+
 [!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
+
+### See also
+
+- [Performance tuning for uploads and downloads](storage-blobs-tune-upload-download.md).