Avalonia C# (Funktionsweise für Entwickler)

Einrichten Ihrer Entwicklungsumgebung

Um mit Avalonia zu entwickeln, müssen Sie Ihre Entwicklungsumgebung einrichten. Sie können Visual Studio oder JetBrains Rider als Ihre IDE verwenden. Installieren Sie zunächst Visual Studio oder JetBrains Rider. Fügen Sie dann die Avalonia Visual Studio Extension zu Ihrer IDE hinzu. Diese Erweiterung bietet Projekttemplates und einen XAML-Vorschau. Es verbessert Ihre Entwicklungserfahrung.

Für diejenigen, die von plattformübergreifenden WPF-Projekten wechseln, bietet Avalonia C# einen vertrauten Entwicklungsprozess, mit Zugang zu externen Links und Ressourcen unterstützt von der .NET Foundation.

Ihre erste Avalonia-Anwendung

Die Erstellung Ihrer ersten Avalonia-Anwendung ist unkompliziert. Öffnen Sie Ihre IDE und wählen Sie die Avalonia-Projektschablone aus. Dies erstellt ein neues Projekt mit der Standard-Avalonia-Konfiguration. Das Projekt beinhaltet ein Hauptfenster und eine Grundkonfiguration. Führen Sie das Projekt aus, um Ihre erste Avalonia-Anwendung in Aktion zu sehen. Sie haben nun Ihre Reise mit Avalonia C# begonnen.

Verständnis von Avalonia UI und XAML

Avalonia UI verwendet XAML für sein Benutzeroberflächendesign. XAML ist eine Auszeichnungssprache, die die UI-Elemente definiert. Hier ist ein einfaches Beispiel für XAML in einer Avalonia-Anwendung:

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Avalonia Example">
    <TextBlock Text="Hello, Avalonia!" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</Window>

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Avalonia Example">
    <TextBlock Text="Hello, Avalonia!" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</Window>

Dieser Code erstellt ein Fenster mit einem Textblock in der Mitte. Der Textblock zeigt "Hello, Avalonia!" an. XAML erleichtert das Design und die Anpassung Ihrer Benutzeroberfläche.

Styling und Steuervorlagen

Avalonia zeichnet sich durch ein flexibles Stil-System aus und unterstützt eine Vielzahl von Designanforderungen. Dieses System ermöglicht es Ihnen, das Aussehen und Gefühl Ihrer Anwendung zu definieren. Sie können Kontrollvorlagen für ein konsistentes Design anpassen. So definieren Sie einen einfachen Stil für einen Button:

<Window.Styles>
    <Style Selector="Button">
        <Setter Property="Background" Value="#007ACC"/>
        <Setter Property="Foreground" Value="White"/>
    </Style>
</Window.Styles>

<Window.Styles>
    <Style Selector="Button">
        <Setter Property="Background" Value="#007ACC"/>
        <Setter Property="Foreground" Value="White"/>
    </Style>
</Window.Styles>

Dieser Stil ändert die Hintergrund- und Textfarbe aller Buttons im Fenster. Das Stil-System von Avalonia unterstützt komplexe Szenarien, einschließlich Themes und Animationen.

Arbeiten mit Daten und Steuerelementen

Datenbindung in Avalonia ermöglicht die Verbindung Ihrer Benutzeroberfläche mit Ihren Datenquellen. Hier ist ein einfaches Beispiel für Datenbindung:

<TextBox Text="{Binding UserName}"/>

<TextBox Text="{Binding UserName}"/>

Dieser Code bindet die Text-Eigenschaft der TextBox an eine UserName-Eigenschaft in Ihrem Datenkontext. Avalonia unterstützt eine Vielzahl von Steuerungen für unterschiedliche Zwecke, wie ListBox, DataGrid und TreeView.

Einführung in IronPDF

IronPDF Library Overview ist eine .NET-Bibliothek, die die Arbeit mit PDFs erleichtert. Es ermöglicht Entwicklern, PDF-Inhalte programmatisch zu erstellen, zu bearbeiten und zu extrahieren. Eine der herausragenden Funktionen von IronPDF ist die Möglichkeit, HTML mit IronPDF in PDF zu konvertieren, was es unglaublich nützlich macht für die Erstellung von Berichten, Rechnungen oder anderen Dokumenten, die als Webseite dargestellt werden können.

Benutzungsfall: Zusammenführung von IronPDF mit Avalonia C#

Stellen Sie sich vor, Sie erstellen eine Desktop-Anwendung mit Avalonia, die Rechnungen als PDFs generieren muss. Ihre Anwendung hat eine schön gestaltete Rechnungs-Vorlage in HTML, die Sie dynamisch mit Details füllen und als PDF speichern möchten. Hier kommt IronPDF ins Spiel. Durch die Integration von IronPDF können Sie Ihre HTML-Rechnungsvorlage mit den ausgefüllten Daten rendern und direkt aus Ihrer Avalonia-Anwendung speichern.

Code-Beispiel: Generierung einer PDF-Rechnung

Unten ist ein umfassendes Beispiel, das zeigt, wie Sie diese Funktion implementieren können. Wir erstellen ein einfaches Avalonia-Fenster mit einem Button. Wenn Sie darauf klicken, generiert die Schaltfläche ein PDF aus einem HTML-String (der als unsere Rechnungsvorlage dient) und speichert es auf Ihrem Computer.

Stellen Sie zunächst sicher, dass Sie die IronPDF- und Avalonia-Pakete in Ihr Projekt installiert haben. Falls nicht, können Sie sie über NuGet hinzufügen.

Lassen Sie uns programmieren:

using Avalonia;
using Avalonia.Controls;
using Avalonia.Interactivity;
using Avalonia.Markup.Xaml;
using IronPdf;

public class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // Attach development tools if in DEBUG mode
        // #if DEBUG
        this.AttachDevTools();
        // #endif

        // Assign event handler for the button click event
        this.FindControl<Button>("GeneratePdfButton").Click += OnGeneratePdfButtonClick;
    }

    private void InitializeComponent()
    {
        // Load the XAML layout into the current window
        AvaloniaXamlLoader.Load(this);
    }

    /// <summary>
    /// Event handler for when the "Generate PDF" button is clicked.
    /// Creates and saves a PDF file from an HTML string.
    /// </summary>
    private void OnGeneratePdfButtonClick(object sender, RoutedEventArgs e)
    {
        var Renderer = new ChromePdfRenderer();

        // Render an HTML string as a PDF document
        var PDF = Renderer.RenderHtmlAsPdf("<html><body><h1>Invoice</h1><p>This is a simple invoice.</p></body></html>");

        // Save the rendered PDF to the file system
        PDF.SaveAs("Invoice.pdf");

        // Display a message box to inform the user that the PDF is generated
        MessageBox.Show(this, "Invoice PDF generated successfully.", "Success");
    }
}

using Avalonia;
using Avalonia.Controls;
using Avalonia.Interactivity;
using Avalonia.Markup.Xaml;
using IronPdf;

public class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();

        // Attach development tools if in DEBUG mode
        // #if DEBUG
        this.AttachDevTools();
        // #endif

        // Assign event handler for the button click event
        this.FindControl<Button>("GeneratePdfButton").Click += OnGeneratePdfButtonClick;
    }

    private void InitializeComponent()
    {
        // Load the XAML layout into the current window
        AvaloniaXamlLoader.Load(this);
    }

    /// <summary>
    /// Event handler for when the "Generate PDF" button is clicked.
    /// Creates and saves a PDF file from an HTML string.
    /// </summary>
    private void OnGeneratePdfButtonClick(object sender, RoutedEventArgs e)
    {
        var Renderer = new ChromePdfRenderer();

        // Render an HTML string as a PDF document
        var PDF = Renderer.RenderHtmlAsPdf("<html><body><h1>Invoice</h1><p>This is a simple invoice.</p></body></html>");

        // Save the rendered PDF to the file system
        PDF.SaveAs("Invoice.pdf");

        // Display a message box to inform the user that the PDF is generated
        MessageBox.Show(this, "Invoice PDF generated successfully.", "Success");
    }
}

Dieser Code definiert eine MainWindow-Klasse für das Hauptfenster unserer Anwendung. Der MainWindow-Konstruktor initialisiert das Fenster und richtet einen Ereignishandler für das Click-Ereignis des Buttons ein. Die OnGeneratePdfButtonClick-Methode behandelt das Klickereignis, indem sie die ChromePdfRenderer-Klasse von IronPDF verwendet, um HTML als PDF-Dokument zu rendern und zu speichern.