RobinManzl.DataAccessLayer 2.4.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package RobinManzl.DataAccessLayer --version 2.4.0
NuGet\Install-Package RobinManzl.DataAccessLayer -Version 2.4.0
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.4.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RobinManzl.DataAccessLayer --version 2.4.0
#r "nuget: RobinManzl.DataAccessLayer, 2.4.0"
#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.4.0

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

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 ColumnAttribut 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.

ColumnAttribute

Das ColumnAttribute bietet, ähnlich wie das TableAttribute, die Möglichkeit, einen vom Property-namen abweichenden Spaltennamen zu verwenden.

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

Möglichkeit hinzugefügt, Spalten bei Update-Operationen auszuschließen; Konfigurations-Möglichkeiten erweitern