![\"Erweiterung](\"..\/fileadmin\/_temp_\/2020_03\/pic_223_013.png\")
<\/p>\nAls selbständiger oder freiberuflicher Softwareentwickler braucht man am Ende vor allem eines: eine Anwendung zum Erstellen von Rechnungen. Diese wollen wir im vorliegenden Artikel programmieren – vom Entwurf des Datenmodells über die Erstellung des Entity Data Models und die Benutzeroberfläche bis zum Ausdrucken der Rechnung als PDF oder mit dem Drucker. Im zweiten Teil der Beitragsreihe fügen wir die Verwaltung von Rechnungspositionen hinzu.<\/b><\/p>\n
Vorüberlegungen<\/b><\/p>\n
Wenn wir unter Access Rechnungen und Rechnungspositionen verwalten wollten, war das sehr einfach möglich – mit einem Haupt- und einem Unterformular. Einzige Bedingung war, dass der Benutzer den neuen, leeren Datensatz im Hauptformular bereits bearbeitet hatte, damit dieser einen Autowert für sein Primärschlüsselfeld erhalten hat. Damit konnte man dann im Unterformular, dessen Datensätze über das Fremdschlüsselfeld mit dem entsprechenden Datensatz im Hauptformular verknüpft waren, direkt die Bestellpositionen eingeben.<\/p>\n
Unter .NET mit WPF und dem Entity Framework ist das ein wenig aufwendiger. In diesem Beispiel wollen wir es so gestalten, dass wir ein Listenfeld zur Anzeige der vorhandenen Rechnungspositionen verwenden, die jeweils zusammen mit den Rechnungsdetails angezeigt werden. Das sieht in der Entwurfsansicht zunächst wie in Bild 1 aus. Von hier aus wollen wir ein weiteres Fenster zur Eingabe von Rechnungspositionen öffnen. Dieses enthält dann jeweils die Daten einer Rechnungsposition. Da diese an eine Rechnung gebunden sein muss, benötigen wir vor dem Speichern einer Rechnungsposition ein Rechnungsobjekt, mit dem diese Rechnung verknüpft ist oder zumindest den Primärschlüsselwert dieser Rechnung. Anderenfalls können wir die Rechnungsposition nicht speichern, da das Fremdschlüsselfeld zum Referenzieren der Rechnung nicht gefüllt wäre.<\/p>\n
<\/p>\n
Bild 1: Erweiterung der Seite zur Anzeige der Rechnungsdetails<\/span><\/b><\/p>\n Bei Access reichte es aus ein Feld eines Datensatzes mit einem Wert zu füllen, um die Vergabe eines Autowerts für das Primärschlüsselfeld auszulösen. Bei dem darauf folgenden Wechsel in das Unterformular, wurde dieser Datensatz automatisch gespeichert und der Primärschlüssel stand ab sofort als Fremdschlüssel für die Anlage der untergeordneten Datensätze zur Verfügung. Unter WPF existiert dieser Automatismus nicht, weshalb wir das gewünschte Verhalten selber entwickeln müssen.<\/p>\n Wir haben unter anderem die folgenden Möglichkeiten:<\/p>\n Beides ist ohnehin an die Validierung gebunden: Bevor der Rechnungsdatensatz nicht vollständig gefüllt wurde, kann dieser nicht gespeichert werden. Das bedeutet, dass wir auch die Freigabe der Schaltfläche zum Anlegen einer neuen Position an das vollständige Ausfüllen der Rechnungsdaten binden können.<\/p>\n Wir wollen den zweiten Weg gehen und das Erstellen der ersten Rechnungsposition erst dann freigeben, wenn der Benutzer alle Rechnungsdaten eingegeben hat – und den Rechnungsdatensatz dann automatisch speichern. Mehr dazu weiter unten – erst folgen noch ein paar Vorbereitungen.<\/p>\n Berechnete Felder vorbereiten<\/b><\/p>\n Wir wollen für die Rechnungspositionen sowohl den Bruttobetrag des Einzelpreises sowie den gesamten Bruttobetrag ausgeben. Dazu benötigen wir zwei berechnete Felder namens Brutto <\/b>und BruttoGesamt<\/b>. Diese beiden Felder stecken nicht in den zugrunde liegenden Tabellen, sondern sie sollen ausschließlich in der Anwendung berechnet werden.<\/p>\n Dazu könnten wir einfach der Klasse Rechnungsposition <\/b>zwei Eigenschaften hinzufügen, welche die Werte auf Basis der Felder Netto<\/b>, Mehrwertsteuersatz <\/b>und Menge <\/b>ermittelt. Allerdings kann es immer mal passieren, dass wir das Datenmodell ändern und die Klassen auf das neue Datenmodell anpassen wollen. Wenn wir das nicht von Hand erledigen, sondern beispielsweise auf Basis des Access-Datenmodells, wie wir es im ersten Teil der Artikelreihe verwendet haben, werden manuelle Änderungen an den Entitätsklassen jedes Mal überschrieben. Also nutzen wir die Möglichkeit, partielle Klassen anzulegen und erstellen eine neue Klasse namens Rechnungsposition_Calc<\/b>. Diese erhält den folgenden Code:<\/p>\n Die Property<\/b>-Eigenschaften unterscheiden sich in verschiedenen Punkten von denen, die wir in der Klasse Rechnungsposition.vb <\/b>vorfinden:<\/p>\n Die Eigenschaft Brutto <\/b>ermitteln wir als das Produkt des Nettopreises mit dem Wert 1 <\/b>plus dem Prozentsatz aus Mehrwertsteuersatz <\/b>geteilt durch 100<\/b>. Für die Eigenschaft BruttoGesamt <\/b>multiplizieren wir dies noch mit dem Wert des Feldes Menge<\/b>.<\/p>\n Aktualisieren der Felder, wenn die zugrunde liegenden Felder aktualisiert werden<\/b><\/p>\n Die Implementierung der Schnittstelle INotifyPropertyChanged <\/b>sorgt in den Entitätsklassen dafür, dass Steuer-elemente, die an Felder dieser Klassen gebunden sind, bei Änderungen der Feldinhalte automatisch aktualisiert werden. Das ist bei den berechneten Eigenschaften nicht der Fall, da diese ja keine Set<\/b>-Property und damit auch keine Möglichkeit für den Einbau des Aufrufs von OnPropertyChanged <\/b>bieten.<\/p>\n Hier müssen wir nun doch noch in den Code der automatisch generierten Entitätsklassen eingreifen. Wir fügen den Eigenschaften, auf denen die berechneten Eigenschaften basieren, Aufrufe der Methode OnPropertyChanged <\/b>hinzu, welche nicht nur die Eigenschaft selbst, sondern auch die berechneten Eigenschaften aktualisieren, die auf dieser Eigenschaft aufbauen:<\/p>\n Auf die gleiche Weise erweitern wir auch die Property Set<\/b>-Eigenschaften Menge <\/b>und Mehrwertsteuersatz<\/b>. Das Ergebnis: Textfelder, welche die berechneten Felder Brutto <\/b>und BruttoGesamt <\/b>anzeigen, werden nun bei Änderung der Werte der Felder Netto<\/b>, Anzahl <\/b>und Mehrwertsteuersatz <\/b>ebenfalls aktualisiert. Wenn Sie tatsächlich einmal das Datenmodell ändern und die Entitätsklassen neu generieren lassen, müssen Sie diese Aufrufe von OnPropertyChanged <\/b>manuell wiederherstellen.<\/p>\n Steuer-elemente zum Verwalten der Rechnungspositionen<\/b><\/p>\n Zum Verwalten der Rechnungspositionen wollen wir folgende Steuer-elemente hinzufügen:<\/p>\n Außerdem soll das Listenfeld per Doppelklick auf einen Eintrag erlauben, die Rechnungsposition zu bearbeiten.<\/p>\n Zum Anlegen und Bearbeiten einer Rechnungsposition soll ein Popup-Fenster mit den Details der Rechnungsposition geöffnet werden. Dieses nennen wir RechnungspositionDetail.xaml<\/b>, das im Entwurf wie in Bild 2 aussehen soll.<\/p>\n Bild 2: Entwurf des Fensters zur Eingabe einer Rechnungsposition<\/span><\/b><\/p>\n RechnungspositionDetail.xaml <\/b>wollen wir nicht als Seite, sondern als Fenster anlegen. Auf diese Weise ist das Hauptfenster mit der Rechnung, für die Rechnungspositionen angelegt werden sollen, immer noch sichtbar und der Benutzer kann prüfen, welche Rechnungspositionen er bereits angelegt hat.<\/p>\n Damit das Fenster in der Mitte angezeigt wird und nicht irgendwo, stellen wir in RechnungspositionenDetail.xaml <\/b>für das Window<\/b>-Element das Attribut WindowStartupLocation <\/b>auf CenterScreen <\/b>ein:<\/p>\n Danach definieren wir die Zeilen und Spalten des Grids:<\/p>\n Die Steuer-elemente, hier ausschließlich Textfelder, binden wir an Elemente des Objekts Rechnungsposition<\/b> und stellen ein entsprechendes Label-Steuerelement voran:<\/p>\n Für das Feld Netto <\/b>legen wir das Format mit StringFormat=C <\/b>fest und sorgen so für die Anzeige des Betrags mit Euro-Zeichen:<\/p>\n Abhängig von den Ländereinstellungen taucht hier dennoch das Dollar-Zeichen als Währungssymbol auf. Um dies zu ändern, fügen Sie der Anwendung für die Datei Application.xaml.vb <\/b>die folgende Methode hinzu, die beim Starten der Anwendung aufgerufen wird. Außerdem benötigen wir dazu die folgenden beiden Namespace<\/b>-Verweise:<\/p>\n Das Feld Menge <\/b>benötigt keine weitere Formatierung:<\/p>\n Für das Feld Mehrwertsteuersatz <\/b>definieren wir das Format mit StringFormat={}{0} %<\/b>. Die vorgegebenen Formate multiplizieren den Wert jeweils mit 100. Sie müssten also die Prozentzahl für 1% mit 0,01 angeben. Das wäre korrekt und ließe sich ebenfalls abbilden, aber hier wählen wir die einfachere Variante – wir müssen dies nur beim Berechnen des Brutto-Preises berücksichtigen, was wir oben in den berechneten Feldern bereits erledigt haben:<\/p>\n Die beiden Felder Brutto <\/b>und BruttoGesamt <\/b>sind die berechneten Felder. Damit der Benutzer diese Werte nicht direkt ändern kann, deaktivieren wir die entsprechenden Textfelder durch Einstellen des Attributs IsEnabled <\/b>auf den Wert False<\/b>. Davon abgesehen greifen wir wie üblich auf die Felder Brutto <\/b>und BruttoGesamt <\/b>zu:<\/p>\n Die beiden Schaltflächen zum Speichern und Verwerfen fassen wir in ein StackPanel<\/b>-Element ein. Die Schaltfläche btnSpeichern <\/b>soll nur aktiviert werden, wenn die Validierungen für die einzugebenden gebundenen Felder erfolgreich sind. Daher fügen wir wieder einen DataTrigger hinzu, der die Validierung der Felder txtBezeichnung<\/b>, txtNetto<\/b>, txtMenge <\/b>und txtMehrwertsteuer <\/b>durchführt und im Falle auch nur eines negativen Ergebnisses die Schaltfläche btnSpeichern <\/b>deaktiviert:<\/p>\n Code des Fensters RechnungspositionDetail.xaml<\/b><\/p>\n Der größte Teil der Funktionen des Fensters wird über die XAML-Definitionen abgedeckt. So bleibt noch das Füllen der anzuzeigenden oder neuen Rechnungsposition. Die dafür notwendigen Elemente werden oben in der Klasse deklariert:<\/p>\n Möchten Sie weiterlesen? Dann lösen Sie Ihr Ticket!<\/span>\n
Partial Public Class Rechnungsposition\r\n Implements INotifyPropertyChanged\r\n Public <\/span>ReadOnly Property Brutto As <\/span>System.Decimal\r\n Get\r\n Return _Netto * (1 + _Mehrwertsteuersatz \/ 100)\r\n End Get\r\n End Property\r\n Public <\/span>ReadOnly Property BruttoGesamt As <\/span>System.Decimal\r\n Get\r\n Return _Netto * (1 + _Mehrwertsteuersatz \/ 100) * Menge\r\n End Get\r\n End Property\r\nEnd Class<\/span><\/pre>\n\n
Public Property <\/span>Netto As <\/span>System.Decimal\r\n Get\r\n Return _Netto\r\n End Get\r\n Set<\/span>\r\n _Netto = Value\r\n OnPropertyChanged(\"Netto\")\r\n OnPropertyChanged(\"Brutto\")\r\n OnPropertyChanged(\"BruttoGesamt\")\r\n End Set<\/span>\r\nEnd Property<\/span> <\/pre>\n\n
![\"Entwurf](\"..\/fileadmin\/_temp_\/2020_03\/pic_223_002.png\")
<\/p>\n<Window x:Class=\"RechnungspositionDetail\"...\r\n Title=\"RechnungspositionDetail\" Height=\"250\" Width=\"405\"\r\n WindowStartupLocation=\"CenterScreen\"><\/pre>\n
<Grid>\r\n <Grid.ColumnDefinitions>\r\n <ColumnDefinition Width=\"Auto\"><\/ColumnDefinition>\r\n ... weitere Spalten\r\n <ColumnDefinition Width=\"*\"><\/ColumnDefinition>\r\n <\/Grid.ColumnDefinitions>\r\n <Grid.RowDefinitions>\r\n <RowDefinition Height=\"Auto\"><\/RowDefinition>\r\n ... weitere Zeilen\r\n <RowDefinition Height=\"*\"><\/RowDefinition>\r\n <\/Grid.RowDefinitions><\/pre>\n
<Label>Bezeichnung:<\/Label>\r\n <TextBox x:Name=\"txtBezeichnung\" Width=\"300\" Grid.Column=\"1\" Text=\"{Binding Rechnungsposition.Bezeichnung, Mode=TwoWay, ValidatesOnDataErrors=True}\"><\/TextBox><\/pre>\n <Label Grid.Row=\"1\">Netto:<\/Label>\r\n <TextBox x:Name=\"txtNetto\" Width=\"100\" Grid.Row=\"1\" Grid.Column=\"1\" Text=\"{Binding Rechnungsposition.Netto, StringFormat=C, Mode=TwoWay, ValidatesOnDataErrors=True}\"><\/TextBox><\/pre>\nImports System.Globalization\r\nImports System.Windows.Markup\r\nClass<\/span> Application\r\n Protected Overrides Sub OnStartup(ByVal e As <\/span>StartupEventArgs)\r\n FrameworkElement.LanguageProperty.OverrideMetadata(GetType(FrameworkElement), New<\/span> FrameworkPropertyMetadata(XmlLanguage.GetLanguage(CultureInfo.CurrentCulture.IetfLanguageTag)))\r\n MyBase.OnStartup(e)\r\n End Sub\r\nEnd Class<\/span><\/pre>\n <Label Grid.Row=\"2\">Menge:<\/Label>\r\n <TextBox x:Name=\"txtMenge\" Width=\"100\" Grid.Row=\"2\" Grid.Column=\"1\" Text=\"{Binding Rechnungsposition.Menge, Mode=TwoWay, ValidatesOnDataErrors=True}\"><\/TextBox><\/pre>\n <Label Grid.Row=\"3\">MwSt:<\/Label>\r\n <TextBox x:Name=\"txtMehrwertsteuersatz\" Width=\"100\" Grid.Row=\"3\" Grid.Column=\"1\" Text=\"{Binding Rechnungsposition.Mehrwertsteuersatz, StringFormat={}{0} %, Mode=TwoWay, ValidatesOnDataErrors=True}\"><\/TextBox><\/pre>\n <Label Grid.Row=\"4\">Brutto:<\/Label>\r\n <TextBox x:Name=\"txtBrutto\" Grid.Row=\"4\" Width=\"100\" Grid.Column=\"1\" IsEnabled=\"False\" Text=\"{Binding Rechnungsposition.Brutto, Mode=OneWay, StringFormat=C}\"><\/TextBox>\r\n <Label Grid.Row=\"5\">Brutto gesamt:<\/Label>\r\n <TextBox x:Name=\"txtBruttoGesamt\" Grid.Row=\"5\" Width=\"100\" Grid.Column=\"1\" IsEnabled=\"False\" Text=\"{Binding Rechnungsposition.BruttoGesamt, Mode=OneWay, StringFormat=C}\"><\/TextBox><\/pre>\n <StackPanel Orientation=\"Horizontal\" Grid.Row=\"6\" Grid.ColumnSpan=\"4\">\r\n <Button x:Name=\"btnSpeichern\" Click=\"btnSpeichern_Click\" Content=\"Speichern\">\r\n <Button.Style>\r\n <Style TargetType=\"{x:Type Button}\" BasedOn=\"{StaticResource {x:Type Button}}\">\r\n <Style.Triggers>\r\n <DataTrigger Binding=\"{Binding ElementName=txtBezeichnung, Path=(Validation.HasError)}\" Value=\"True\">\r\n <Setter Property=\"IsEnabled\" Value=\"False\"><\/Setter>\r\n <\/DataTrigger>\r\n <DataTrigger Binding=\"{Binding ElementName=txtNetto, Path=(Validation.HasError)}\" Value=\"True\">\r\n <Setter Property=\"IsEnabled\" Value=\"False\"><\/Setter>\r\n <\/DataTrigger>\r\n <DataTrigger Binding=\"{Binding ElementName=txtMenge, Path=(Validation.HasError)}\" Value=\"True\">\r\n <Setter Property=\"IsEnabled\" Value=\"False\"><\/Setter>\r\n <\/DataTrigger>\r\n <DataTrigger Binding=\"{Binding ElementName=txtMehrwertsteuer, Path=(Validation.HasError)}\" Value=\"True\">\r\n <Setter Property=\"IsEnabled\" Value=\"False\"><\/Setter>\r\n <\/DataTrigger>\r\n <\/Style.Triggers>\r\n <\/Style>\r\n <\/Button.Style>\r\n <\/Button>\r\n <Button x:Name=\"btnVerwerfen\" Click=\"btnVerwerfen_Click\" Content=\"Verwerfen\"><\/Button>\r\n <\/StackPanel>\r\n <\/Grid>\r\n<\/Window><\/pre>\nImports System.ComponentModel\r\nPublic Class<\/span> RechnungspositionDetail\r\n Private <\/span>dbContext As <\/span>RechnungsverwaltungContext\r\n Private <\/span>_rechnungsposition As <\/span>Rechnungsposition<\/pre>\n
\nHier geht es zur Bestellung des Jahresabonnements des Magazins Visual Basic Entwickler<\/strong>:<\/span>
\nZur Bestellung ...<\/a><\/span>
\nDanach greifen Sie sofort auf alle rund 200 Artikel<\/strong> unseres Angebots zu - auch auf diesen hier!<\/span>
\nOder haben Sie bereits Zugangsdaten? Dann loggen Sie sich gleich hier ein:<\/span><\/p>\n<\/div>\n\n\t\n\t