.NET MAUI BarCode 掃描器

Q: 我如何在.NET MAUI應用中將掃描的條碼文字複製到剪貼簿？

在您的.NET MAUI應用中使用 Clipboard.SetTextAsync 方法將掃描的條碼文字複製到剪貼簿。此方法可以通過按鈕點擊觸發，顯示一個提醒以確認操作。

Updated: 2026年6月29日

簡介

.NET MAUI（.NET 多平台應用程式使用者介面）是一個跨平台框架，可透過單一程式碼庫無縫建立跨平台應用程式。例如，您可以在同一個專案中輕鬆建立 Microsoft Windows、iOS 和 Android 應用程式。它與其他平台、框架及函式庫的區別在於，它讓開發者社群能在專案中使用原生控制項，並為其提供額外的元件。因此，開發人員可以利用這些現成的元件和服務，無需從頭編寫所有程式碼，就能更快速地建置應用程式。

本文將說明如何在 .NET MAUI Windows 應用程式中整合 IronBarcode，以掃描條碼或 QR 碼。

如何在 .NET MAUI 中讀取與掃描 BarCode

安裝 C# 函式庫以讀取和掃描 BARCODE
根據任務要求，使用 .NET MAUI 設計應用程式前端
取得指定BarCode圖片的路徑
請使用 Read 方法來掃描提供的BarCode
使用 SetTextAsync 方法

IronBarcode：C# BarCode程式庫

為了在我們的應用程式中讀取條碼，我們將使用 IronBarcode .NET 程式庫。它提供了一個強大且簡單的 API 來讀取 BARCODE，讓開發者無需任何麻煩或 BARCODE 領域的專業知識即可進行開發。可透過 NuGet 套件管理員輕鬆安裝。

IronBarcode 支援讀取多種 BARCODE 格式，包括 Code 39、Code 128、PDF417 等眾多格式。您可以讀取多種資料格式，例如圖像檔案、記憶體流和 PDF 檔案。

在 .NET MAUI 應用程式中讀取 BARCODE 的步驟

請依照以下步驟，在 .NET MAUI 應用程式中讀取 BARCODE。

先決條件

Visual Studio 2022
Visual Studio 中的 .NET MAUI 專案

安裝 IronBarcode 程式庫

我們可以透過 NuGet 安裝 IronBarcode 程式庫 Package Manager Console。要在 Visual Studio 中開啟此控制台，請導航至 Tools > NuGet Package Manager > Package Manager Console。接著，在控制台輸入以下指令：

PM > Install-Package BarCode

Install-Package BarCode

此控制台指令將下載 MAUI 專案中 IronBarcode程式庫的最新版本。此外，您也可以在 NuGet 網站上搜尋 NuGet 套件的最新版本。

前端

第一步將是建立前端設計。為此，我們將建立一個由兩個按鈕、一個文字輸入區及一個圖片框所組成的版面配置。將使用一個按鈕來選取BarCode，另一個按鈕則用於複製BarCode的文字內容。 "圖片"方塊將顯示所選的圖片。

請將 MainPage.xaml 檔案中的內容替換為以下內容：

<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUI_Barcode.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Button
                x:Name="ImageSelect"
                Text="Select Barcode"
                SemanticProperties.Hint="Select Image"
                Clicked="SelectBarcode"
                HorizontalOptions="Center" />
            <Image
                x:Name="barcodeImage"
                SemanticProperties.Description="Selected Barcode"
                HeightRequest="200"
                HorizontalOptions="Center" />
            <Editor
                x:Name="outputText"
                Placeholder="Output text"
                HeightRequest="100"
                WidthRequest="500" />
            <Button
                x:Name="copyText"
                Text="Copy"
                SemanticProperties.Hint="Copy Text"
                WidthRequest="150"
                Clicked="CopyEditorText"
                HorizontalOptions="Center" />

        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUI_Barcode.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Button
                x:Name="ImageSelect"
                Text="Select Barcode"
                SemanticProperties.Hint="Select Image"
                Clicked="SelectBarcode"
                HorizontalOptions="Center" />
            <Image
                x:Name="barcodeImage"
                SemanticProperties.Description="Selected Barcode"
                HeightRequest="200"
                HorizontalOptions="Center" />
            <Editor
                x:Name="outputText"
                Placeholder="Output text"
                HeightRequest="100"
                WidthRequest="500" />
            <Button
                x:Name="copyText"
                Text="Copy"
                SemanticProperties.Hint="Copy Text"
                WidthRequest="150"
                Clicked="CopyEditorText"
                HorizontalOptions="Center" />

        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

XML

所有元素均以垂直堆疊方式排列，並居中對齊。您可以根據個人偏好進行調整。

使用 IronBarcode 進行條碼掃描

本節將說明如何使用 IronBarcode程式庫掃描條碼的程式碼。首先，我們將使用 FilePicker 來選取檔案並指定圖片的檔案型別。接著，我們將使用 FullPath 屬性來取得圖片檔案的路徑，然後將圖片框的來源設定為 FullPath 的值。最後，我們將在 BarcodeReader 的 Read 函式中使用 path 值來擷取文字。

private async void SelectBarcode(object sender, EventArgs e)
{
    // Use FilePicker to allow the user to select an image file.
    var images = await FilePicker.Default.PickAsync(new PickOptions
    {
        PickerTitle = "Pick image",
        FileTypes = FilePickerFileType.Images
    });

    // Get the full path of the selected image file.
    var imageSource = images.FullPath.ToString();

    // Set the source of the Image view to the selected image's path.
    barcodeImage.Source = imageSource;

    // Use IronBarcode to read the barcode from the image file and get the first result.
    var result = BarcodeReader.Read(imageSource).First().Text;

    // Display the read result in the Editor.
    outputText.Text = result;
}

private async void SelectBarcode(object sender, EventArgs e)
{
    // Use FilePicker to allow the user to select an image file.
    var images = await FilePicker.Default.PickAsync(new PickOptions
    {
        PickerTitle = "Pick image",
        FileTypes = FilePickerFileType.Images
    });

    // Get the full path of the selected image file.
    var imageSource = images.FullPath.ToString();

    // Set the source of the Image view to the selected image's path.
    barcodeImage.Source = imageSource;

    // Use IronBarcode to read the barcode from the image file and get the first result.
    var result = BarcodeReader.Read(imageSource).First().Text;

    // Display the read result in the Editor.
    outputText.Text = result;
}

Private Async Sub SelectBarcode(ByVal sender As Object, ByVal e As EventArgs)
	' Use FilePicker to allow the user to select an image file.
	Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
		.PickerTitle = "Pick image",
		.FileTypes = FilePickerFileType.Images
	})

	' Get the full path of the selected image file.
	Dim imageSource = images.FullPath.ToString()

	' Set the source of the Image view to the selected image's path.
	barcodeImage.Source = imageSource

	' Use IronBarcode to read the barcode from the image file and get the first result.
	Dim result = BarcodeReader.Read(imageSource).First().Text

	' Display the read result in the Editor.
	outputText.Text = result
End Sub

Private Async Sub SelectBarcode(ByVal sender As Object, ByVal e As EventArgs)
	' Use FilePicker to allow the user to select an image file.
	Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
		.PickerTitle = "Pick image",
		.FileTypes = FilePickerFileType.Images
	})

	' Get the full path of the selected image file.
	Dim imageSource = images.FullPath.ToString()

	' Set the source of the Image view to the selected image's path.
	barcodeImage.Source = imageSource

	' Use IronBarcode to read the barcode from the image file and get the first result.
	Dim result = BarcodeReader.Read(imageSource).First().Text

	' Display the read result in the Editor.
	outputText.Text = result
End Sub

以下程式碼將用於複製文字編輯器中的文字，並向使用者顯示一則提示訊息，告知文字已成功複製。

private async void CopyEditorText(object sender, EventArgs e)
{
    // Copy the text from the Editor to the clipboard.
    await Clipboard.SetTextAsync(outputText.Text);

    // Show a success message to the user.
    await DisplayAlert("Success", "Text is copied!", "OK");
}

private async void CopyEditorText(object sender, EventArgs e)
{
    // Copy the text from the Editor to the clipboard.
    await Clipboard.SetTextAsync(outputText.Text);

    // Show a success message to the user.
    await DisplayAlert("Success", "Text is copied!", "OK");
}

Private Async Sub CopyEditorText(ByVal sender As Object, ByVal e As EventArgs)
	' Copy the text from the Editor to the clipboard.
	Await Clipboard.SetTextAsync(outputText.Text)

	' Show a success message to the user.
	Await DisplayAlert("Success", "Text is copied!", "OK")
End Sub

Private Async Sub CopyEditorText(ByVal sender As Object, ByVal e As EventArgs)
	' Copy the text from the Editor to the clipboard.
	Await Clipboard.SetTextAsync(outputText.Text)

	' Show a success message to the user.
	Await DisplayAlert("Success", "Text is copied!", "OK")
End Sub

You can find the project source code in this article on GitHub.

輸出

執行專案後，您將看到以下輸出結果。圖片尚未顯示，因為尚未選取。

未選取圖片時的輸出內容

選取 BarCode 後，畫面將如下方截圖所示，且 QR 碼的輸出文字會顯示在編輯器中。

選取圖片後的輸出內容

點擊"複製"按鈕將觸發前述的警示視窗出現。

複製提示

結論

在本文中，我們說明了如何在 .NET MAUI 應用程式中使用 IronBarcode 讀取條碼。作為 QR 碼讀取工具，IronBarcode 的表現非常出色——它能提供完全符合預期的輸出結果。此外，它還能讀取難以辨識的BARCODE。您也可以使用不同的字型來建立和自訂BarCode。請透過此連結查看更多關於 IronBarcode 的教學文章。

IronBarcode 必須取得授權，方可進行開發及商業用途。您可在此處查閱更多授權相關資訊。

常見問題

如何在.NET MAUI應用中掃描QR Code？

您可以在.NET MAUI應用中使用IronBarcode程式庫掃描QR Code。在Visual Studio中通過NuGet套件管理器安裝程式庫，並使用BarcodeReader.Read方法從選定的圖像文件中提取文字。

在.NET MAUI專案中安裝IronBarcode的過程是什麼？

要在.NET MAUI專案中安裝IronBarcode，請在Visual Studio中開啟NuGet套件管理器控制台並執行命令Install-Package Barcode下載並安裝程式庫。

使用IronBarcode程式庫可以讀取哪些條碼格式？

IronBarcode支援多種條碼格式，包括QR Code、Code 39、Code 128、PDF417等，允許在應用程式中實現多功能的條碼讀取能力。

我如何在.NET MAUI中設計條碼掃描器應用的介面？

在.NET MAUI中，條碼掃描器應用的介面可以使用XAML設計。通常，它包括一個布局，包含按鈕、文字區域和圖像框，可以在MainPage.xaml文件中定義。

我如何在.NET MAUI應用中將掃描的條碼文字複製到剪貼簿？

在您的.NET MAUI應用中使用Clipboard.SetTextAsync方法將掃描的條碼文字複製到剪貼簿。此方法可以通過按鈕點擊觸發，顯示一個提醒以確認操作。

是否可以在.NET MAUI中使用IronBarcode自訂條碼外觀？

是的，IronBarcode允許通過提供改變字體、顏色和樣式的選項來自訂條碼外觀，從而能夠建立視覺上量身定制的條碼。

我需要授權才能在商業應用中使用IronBarcode嗎？

是的，在開發和商業用途中使用IronBarcode需要授權。授權細節和選項可在IronBarcode網站上查詢。

我可以在哪裡獲得.NET MAUI條碼掃描器教程的源程式碼？

關於.NET MAUI條碼掃描器教程的源程式碼可在GitHub上獲得。文章中提供了指向儲存庫的連結以便於存取。

IronBarcode如何增強.NET MAUI應用中的條碼掃描功能？

IronBarcode通過提供支援多種條碼格式的強大API和與.NET MAUI專案的無縫整合，增強.NET MAUI應用中的條碼掃描功能，確保有效和準確的條碼讀取。

Do I need a license to use IronBarcode in a commercial application?

Yes, IronBarcode requires a license for both development and commercial use. More information on licensing can be found on the IronBarcode licensing page.