RobinManzl.DataAccessLayer 2.5.3

There is a newer version of this package available.
See the version list below for details.
dotnet add package RobinManzl.DataAccessLayer --version 2.5.3
NuGet\Install-Package RobinManzl.DataAccessLayer -Version 2.5.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RobinManzl.DataAccessLayer" Version="2.5.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RobinManzl.DataAccessLayer --version 2.5.3
#r "nuget: RobinManzl.DataAccessLayer, 2.5.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install RobinManzl.DataAccessLayer as a Cake Addin
#addin nuget:?package=RobinManzl.DataAccessLayer&version=2.5.3

// Install RobinManzl.DataAccessLayer as a Cake Tool
#tool nuget:?package=RobinManzl.DataAccessLayer&version=2.5.3

Vorbereitung

Datenbank

Bevor das Framework verwendet werden kann, muss eine Datenbanktabelle erstellt werden. Das Framework geht von Tabellen mit mindestens einem Attribut aus, das mit dem PrimaryKeyAttribute als Primärschlüssel markiert wurde. Diese Spalte muss als Identitätsspalte festgelegt werden, während alle restlichen Attribute der Tabelle sind frei wählbar.

Entitätsklassen

Um die Daten einer erstellten Tabelle abfragen zu können, muss eine passende Entitätsklasse erstellt werden, wobei der Klassenname dem Tabellennamen entsprechen muss. Jede Property, welche von der Datenbanktabelle gemappt werden soll, muss mit dem ColumnAttribute versehen werden. Hier gilt auch wieder Einschränkung, dass die Properties dieselben Namen wie die Spalten in der Tabelle besitzen müssen.

Daten abrufen

Zeilen einer Tabelle kann mit Hilfe der DbService-Klasse abgerufen werden. Diese Klasse ist generisch und erwartet als Typparameter die Entitätsklasse, welche zu der entsprechenden Tabelle passt. Mit der Methode GetEntities können die Objekte dann von der Tabelle abgerufen werden.

QueryCondition

Um die WHERE-Klausel der Abfrage anzugeben, dient die Klasse QueryCondition. Sie ist abstrakt und wird von diversen anderen Klassen geerbt. Es ist beispielsweise mit der ValueCompareCondition-Klasse möglich, die Zeilen anhand einem Wertvergleich zu filtern. Alternativ kann auch eine Expression vom Typ Func<T,bool> angegeben werden, wobei T der Entitätsklasse entspricht.

QueryOptions

Die Klasse QueryOptions dient dazu, dem DbService diverse Optionen zu übergeben. Z.B. kann angegeben werden, wie viele Zeilen maximal von der Datenbank zurückgegeben werden sollen. Die Angabe von bis zu drei Spalten für die Sortierung kann auch über diese Klasse bewerkstelligt werden.

Daten ändern

Daten können mithilfe der InsertEntity-, der UpdateEntity- und der DeleteEntity-Methoden verändert werden unter der Angabe einer Instanz der Entitätsklasse.

Besonderheiten

TableAttribute

Mit dem TableAttribute ist es möglich, die Entitätsklasse anders zu benennen, wie die zugehörige Tabelle. Zusätzlich kann noch ein Schema angegeben werden, welches die Tabelle verwendet. Bei der Verwendung des Standardschemas - dbo - kann dieses Feld ignoriert werden. Über das Flags-Feld AllowedActions kann festgelegt werden, welche Aktionen für diese Entitäts-Klasse gestattet sein sollen. Bei einer ausgeschlossenen Aktion wirft der DbService eine Ausnahme, um sie zu verhindern.

ColumnAttribute

Das ColumnAttribute bietet, ähnlich wie das TableAttribute, die Möglichkeit, einen vom Property-namen abweichenden Spaltennamen zu verwenden. Außerdem kann über das Feld IsUpdateEnabled gesteuert werden, ob die Spalte beim Update-Command mit eingeschlossen werden soll. Weiterhin bietet des Feld IsComputedColumn die Möglichkeit, eine Spalte als berechnete Spalte zu markieren. Dies hat zur Folge, dass sie beim Insert- sowie beim Update-Command ausgeschlossen wird, jedoch bei der Abfrage von der Datenbank mitgeladen wird.

Views

Es gibt die Möglichkeit, Daten auch direkt von Views abzufragen. Hierfür existiert ein eigenes Attribut, welches anstelle des TableAttribute verwendet werden soll. Das ViewAttribute besitzt zusätzlich zum Namen der View noch Felder für die Angabe von Stored Procedures, die bei den Methoden zur Änderung von Zeilen verwendet werden. Die beiden Stored Procedures, welche für Insert- und Update-Vorgänge verwendet werden, sollten für jedes Attribut der Entitätsklasse einen entsprechenden Parameter besitzen. Die letzte Stored Procedure für Löschvorgänge hingegen sollte nur den Parameter für den Primärschlüssel besitzen.

Transaktionen

Transaktionen werden mittels den Methoden BeginTransaction und RemoveTransaction begonnen und entfernt. Das Abbrechen bzw. das Anwenden der Transaktion muss direkt mit der zurückgelieferten SqlTransaction erledigt werden. Um Transaktionen über mehrere Instanzen der DbService-Klasse zu verwenden, akzeptiert die BeginTransaction-Methode optional eine SqlTransaction.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on RobinManzl.DataAccessLayer:

Package Downloads
RobinManzl.DataAccessLayer.JsonConfiguration

Erleichtert die Konfiguration des DataAccessLayer mittels JSON-File

RobinManzl.DataAccessLayer.HistoryExtension

Ermöglicht die Historisierung der Daten auf Zeilenbasis

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.13 607 7/7/2020
3.0.12 478 6/26/2020
3.0.11 424 6/18/2020
3.0.10 428 6/11/2020
3.0.9 489 4/17/2020
3.0.8 493 4/15/2020
3.0.7 489 4/8/2020
3.0.6 487 3/31/2020
3.0.5 471 3/17/2020
3.0.4 454 2/29/2020
3.0.3 486 2/27/2020
3.0.2 458 2/27/2020
3.0.1 686 2/19/2020
2.5.7 675 1/27/2020
2.5.6 6,130 1/21/2020
2.5.5 537 1/20/2020
2.5.4 560 1/19/2020
2.5.3 480 1/17/2020
2.4.1 521 1/15/2020
2.4.0 548 1/14/2020
2.3.7 506 1/10/2020
2.3.6 576 9/30/2019
2.3.5 487 9/29/2019
2.3.4 478 9/29/2019
2.3.3 490 9/29/2019
2.3.2 512 9/29/2019
2.2.5 486 9/25/2019
2.1.6 503 9/23/2019
2.1.4 716 9/19/2019
2.1.3 543 9/19/2019
2.1.2 555 7/4/2019
2.1.1 510 7/4/2019
2.0.2 569 5/6/2019
2.0.1 563 5/6/2019
1.8.1 582 2/26/2019
1.8.0 589 2/25/2019
1.7.8 722 1/14/2019
1.7.3 660 12/19/2018
1.7.2 635 12/6/2018
1.7.1 676 12/3/2018
1.7.0 690 11/13/2018
1.6.8 681 11/12/2018
1.5.3 727 10/22/2018
1.5.2 693 10/22/2018

ValidateEntityClasses-Option entfernt;
Fehlerbehandlung bei Verwendung von LinkedEntities verbessert;
Möglichkeit hinzugefügt, über das ColumnAttribute einen Spalten-Konverter anzugeben;
Neuladen der Entitäten für Post-Plugins eingebaut;
ColumnConverter um Möglichkeit ergänzt, den SQL-Datentypen explizit anzugeben