使用 Visual Studio 連線服務新增 Azure 記憶體
使用 Visual Studio,您可以使用 連線服務 功能,將下列任一項連線至 Azure 記憶體:
- .NET Framework 控制台應用程式
- ASP.NET 模型-View-Controller (MVC) (.NET Framework)
- ASP.NET Core
- .NET Core (包括控制台應用程式、WPF、Windows Forms、類別庫)
- .NET Core 工作者角色
- Azure Functions(Azure 函數)
- 通用 Windows 平台應用程式
- Xamarin
- 科爾多瓦
線上的服務功能會將所有必要的參考和連線程式代碼新增至專案,並適當地修改組態檔。
先決條件
- Visual Studio (請參閱 [Visual Studio 下載] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)),並已安裝 Azure 開發 工作負載。
- 支援類型之一的專案
- Azure 帳戶。 如果您沒有 Azure 帳戶,請為 Visual Studio 訂閱者啟用 Azure 權益, 或 註冊免費試用。
使用連接服務連線到 Azure 儲存體
在 Visual Studio 中開啟您的專案。
在 [方案總管]中,以滑鼠右鍵按兩下 [連線服務] 節點,然後從操作功能表中選取 [[新增已連線的服務]。
在 [連線服務] 索引標籤中,選取 [服務相依性的 + 圖示。
在 [[新增相依性] 頁面中,選取 [Azure 儲存體]。
如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊 免費試用。
在 [設定 Azure 儲存體] 畫面中,選取現有的儲存帳戶,然後選取 [下一步 ]。
如果您需要建立記憶體帳戶,請移至下一個步驟。 否則,請跳至步驟 6。
若要建立記憶體帳戶:
請在對話框底部選取 建立儲存體帳戶。
填寫 [Azure 儲存體:建立新的] 對話框,然後選取 [建立]。
當 [Azure 記憶體] 對話框顯示時,新的記憶體帳戶會出現在清單中。 選取清單中的新記憶體帳戶,然後選取 [[下一步]。
輸入連接字串名稱,然後選擇您要將連接字串儲存在本機秘密檔案中,還是 Azure Key Vault。
變更摘要 畫面會顯示如果您完成過程,將會對您的專案進行的所有修改。 如果變更看起來正常,請選擇 完成。
記憶體連線服務會出現在專案的 連線服務 節點底下。
在 Visual Studio 中開啟您的專案。
按 Ctrl+Q(或使用主功能表欄右側的 Visual Studio IDE 中的 [搜尋] 按鈕)。
在 [功能搜尋中,輸入
Azure Storage
,然後選擇 [Azure 記憶體 - Project > 連線服務] > [新增 azure 記憶體 >]。在 [連線至相依性] 頁面中,選取 [Azure 儲存體],然後選取 [下一步]。
如果您尚未登入,請登入您的 Azure 帳戶。 如果您沒有 Azure 帳戶,您可以註冊 免費試用。
在 [連線至 Azure 儲存體] 畫面中,選取現有的儲存體帳戶,然後選取 [下一步] 。
如果您需要建立記憶體帳戶,請移至下一個步驟。 否則,請跳至下列步驟。
若要建立記憶體帳戶:
選取 [綠色加號建立新的。
填寫 Azure 儲存:建立新的 對話框,然後選取 建立。
當 [Azure 記憶體] 對話框顯示時,新的記憶體帳戶會出現在清單中。 選取清單中的新記憶體帳戶,然後選取 [[下一步]。
輸入連接字串設定名稱。 設定名稱會參考連接字串設定的名稱,因為它出現在 secrets.json 檔案或 Azure Key Vault 中。
選擇您要將連接字串儲存在本機秘密檔案、Azure Key Vault中,還是不要儲存在任何地方。
謹慎
如果您使用 Visual Studio 17.12 之前的 Visual Studio 版本,而且選擇使用 secrets.json 檔案,您必須採取安全性預防措施,因為本機 secrets.json 檔案中的連接字串可能會公開。 如果您使用 Visual Studio 2022 17.12 版或更新版本,此程式會產生更安全的結果,因為它會產生連線設定值,而不是具有驗證認證的連接字串。
變更摘要 畫面顯示如果您完成此過程,將對專案進行的所有修改。 如果變更看起來正常,請選擇 完成。
記憶體連線服務會出現在專案的 連線服務 節點底下。
了解驗證
執行上一個程式之後,您的應用程式會設定為使用驗證來存取記憶體帳戶。 如果您選擇 secrets.json 方法,或 Azure 金鑰保存庫中,此驗證的連線資訊會儲存在本機。
如果您使用 secrets.json 檔案,請使用 [連線 服務] 索引標籤上 Secrets.json 旁的三個點開啟檔案,以開啟功能表,然後選擇 [管理使用者密碼] 。 使用 Visual Studio 2022 17.12 版和更新版本時,此檔案包含參考 URI 以取得安全連接字串串的設定,而不是連接字元串本身。
{
"StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
"StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
"StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}
在 Visual Studio 17.12 和更新版本中,驗證是自動且有彈性的。 當您從 Visual Studio 本機執行或偵錯時,Visual Studio 所儲存的 Azure 認證會用來存取 Azure 儲存器帳戶。 如果您從命令行啟動應用程式,您必須先使用 Azure CLI 登入,然後會自動偵測及使用這些認證。 但是當您的應用程式部署至 Azure 並在 Azure 中執行時,它會使用受控識別,而不需要變更任何程式碼。 驗證適用於所有主機環境,因為 Azure 身分識別 API 會依序檢查所有鏈結的憑證,並在找到時加以使用。 請參閱 DefaultAzureCredential。
後續步驟
Azure 儲存體支援 Blob 和佇列,以及其他功能。
若要瞭解如何使用 Blob,您可以繼續進行 Blob 儲存體的快速入門,不必從頭開始,您可以從 Azure blobs 快速入門 (.NET) - 程式碼範例開始。
若要瞭解如何使用佇列,請從 Azure 佇列記憶體快速入門 (.NET) 開始 - 程式代碼範例。