RobinManzl.DataAccessLayer 3.0.13

dotnet add package RobinManzl.DataAccessLayer --version 3.0.13                
NuGet\Install-Package RobinManzl.DataAccessLayer -Version 3.0.13                
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="3.0.13" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RobinManzl.DataAccessLayer --version 3.0.13                
#r "nuget: RobinManzl.DataAccessLayer, 3.0.13"                
#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=3.0.13

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

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 netcoreapp3.1 is compatible. 
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 674 7/7/2020
3.0.12 513 6/26/2020
3.0.11 458 6/18/2020
3.0.10 463 6/11/2020
3.0.9 523 4/17/2020
3.0.8 522 4/15/2020
3.0.7 521 4/8/2020
3.0.6 516 3/31/2020
3.0.5 502 3/17/2020
3.0.4 488 2/29/2020
3.0.3 518 2/27/2020
3.0.2 488 2/27/2020
3.0.1 758 2/19/2020
2.5.7 703 1/27/2020
2.5.6 6,165 1/21/2020
2.5.5 570 1/20/2020
2.5.4 593 1/19/2020
2.5.3 498 1/17/2020
2.4.1 553 1/15/2020
2.4.0 578 1/14/2020
2.3.7 526 1/10/2020
2.3.6 613 9/30/2019
2.3.5 523 9/29/2019
2.3.4 509 9/29/2019
2.3.3 520 9/29/2019
2.3.2 549 9/29/2019
2.2.5 519 9/25/2019
2.1.6 536 9/23/2019
2.1.4 758 9/19/2019
2.1.3 574 9/19/2019
2.1.2 586 7/4/2019
2.1.1 541 7/4/2019
2.0.2 600 5/6/2019
2.0.1 595 5/6/2019
1.8.1 617 2/26/2019
1.8.0 622 2/25/2019
1.7.8 753 1/14/2019
1.7.3 689 12/19/2018
1.7.2 668 12/6/2018
1.7.1 716 12/3/2018
1.7.0 720 11/13/2018
1.6.8 713 11/12/2018
1.5.3 765 10/22/2018
1.5.2 733 10/22/2018