Gallery verwendet Datenbank

- Menü: Fixed typo in Gallerie
- Datenbanken-Funktionen dokumentiert

DataAccess/Data/BildInfoData.cs

@@ -1,14 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Runtime.CompilerServices;
-using System.Text;
-using System.Threading.Tasks;
-using DataAccess.DbAccess;
+using DataAccess.DbAccess;
 using DataAccess.Models;
 
 namespace DataAccess.Data;
 
+/// <summary>
+/// Ermöglicht den Zugriff auf die BildInfo Datenbank.
+/// </summary>
 public class BildInfoData
 {
     private readonly ISqlDataAccess _db;
@@ -18,18 +15,34 @@ public class BildInfoData
         _db = db;
     }
 
+    /// <summary>
+    /// Fügt die gegebene BildInfo zur Datenbank hinzu und aktualisiert das <see cref="BildInfoModel.Id"/>-Feld mit dem entsprechenden Wert.
+    /// </summary>
+    /// <param name="bildInfo">Die BildInfo, die zur Datenbank hinzugefügt werden soll.</param>
     public async Task AddBildInfoAsync(BildInfoModel bildInfo)
     {
         var id = await _db.LoadData<int, BildInfoModel>("dbo.spBildInfo_Insert", bildInfo);
         bildInfo.Id = id.Single();
     }
     
-    public async Task UpdateBildInfoDateinameAsync(BildInfoModel bildInfo)
+    /// <summary>
+    /// Aktualisiert das Dateiname-Feld der übergebenen BildInfo in der Datenbank.
+    /// </summary>
+    /// <param name="bildInfo">Die BildInfo deren Dateiname aktualisiert werden soll.</param>
+    public Task UpdateBildInfoDateinameAsync(BildInfoModel bildInfo)
     {
-        await _db.SaveData("dbo.spBildInfo_UpdateFileName",
+        return _db.SaveData("dbo.spBildInfo_UpdateFileName",
         new {
             Id = bildInfo.Id,
             Dateiname = bildInfo.Dateiname,
         });
     }
+
+    /// <summary>
+    /// Gibt alle Bild Infos der Datenbank zurück.
+    /// </summary>
+    public Task<IEnumerable<BildInfoModel>> GetAllBildInfosAsync()
+    {
+        return _db.LoadData<BildInfoModel, dynamic>("dbo.spBildInfo_GetAll", new { });
+    }
 }

DataAccess/Data/WunschInfoData.cs

@@ -22,4 +22,15 @@ public class WunschInfoData
         var id = await _db.LoadData<int, WunschInfoModel>("dbo.spWunschInfo_Insert", wunschInfo);
         wunschInfo.Id = id.Single();
     }
+
+    /// <summary>
+    /// Gibt die WunschInfo mit der gegebenen Id zurück.
+    /// </summary>
+    /// <param name="wunschId">Die Id der zu ladenen WunschInfo</param>
+    /// <returns>Die WunschInfo mit der gegebenen Id</returns>
+    public async Task<WunschInfoModel> GetWunschInfoAsync(int wunschId)
+    {
+        var wunschInfo = await _db.LoadData<WunschInfoModel, dynamic>("dbo.spWunschInfo_Get", new { Id = wunschId });
+        return wunschInfo.Single();
+    }
 }

DataAccess/DbAccess/ISqlDataAccess.cs

@@ -1,7 +1,26 @@
 namespace DataAccess.DbAccess;
 
+/// <summary>
+/// Bietet lesenden und schreibenden Zugriff auf eine Datenbank.
+/// </summary>
 public interface ISqlDataAccess
 {
-    Task<IEnumerable<T>> LoadData<T, U>(string storedProcedure, U parameters, string connectionId = "Default");
-    Task SaveData<T>(string storedProcedure, T parameters, string connectionId = "Default");
+    /// <summary>
+    /// Führt die angegebene Stored Procedure aus. Diese Prozedur nimmt Parameter des Typs <see cref="TParameter"/> engegen und gibt ein Enumerable des Typs <see cref="TResult"/> zurück.
+    /// </summary>
+    /// <typeparam name="TResult">Der Typ der Parameter</typeparam>
+    /// <typeparam name="TParameter">Der Typ der Rückgabewerte</typeparam>
+    /// <param name="storedProcedure">Der Name der Prozedur</param>
+    /// <param name="parameters">Die Parameter für die Prozedur.</param>
+    /// <param name="connectionId">Die optionale Id des zu verwendenen Connection Strings.</param>
+    Task<IEnumerable<TResult>> LoadData<TResult, TParameter>(string storedProcedure, TParameter parameters, string connectionId = "Default");
+    
+    /// <summary>
+    /// Führt die angegebene Stored Procedure aus. Diese Prozedur nimmt Parameter des Typs <see cref="TParameter"/> engegen und gibt nichts zurück.
+    /// </summary>
+    /// <typeparam name="TParameter">Der Typ der Parameter</typeparam>
+    /// <param name="storedProcedure">Der Name der Prozedur</param>
+    /// <param name="parameters">Die Parameter für die Prozedur.</param>
+    /// <param name="connectionId">Die optionale Id des zu verwendenen Connection Strings.</param>
+    Task SaveData<TParameter>(string storedProcedure, TParameter parameters, string connectionId = "Default");
 }

DataAccess/DbAccess/SqlDataAccess.cs

@@ -5,6 +5,9 @@ using Dapper;
 
 namespace DataAccess.DbAccess;
 
+/// <summary>
+/// Bietet lesenden und schreibenden Zugriff auf eine Datenbank.
+/// </summary>
 public class SqlDataAccess : ISqlDataAccess
 {
     private readonly IConfiguration _config;
@@ -14,14 +17,14 @@ public class SqlDataAccess : ISqlDataAccess
         _config = config;
     }
     
-    public async Task<IEnumerable<T>> LoadData<T, U>(string storedProcedure, U parameters, string connectionId = "Default")
+    public async Task<IEnumerable<TResult>> LoadData<TResult, TParameter>(string storedProcedure, TParameter parameters, string connectionId = "Default")
     {
         using IDbConnection connection = new SqlConnection(_config.GetConnectionString(connectionId));
 
-        return await connection.QueryAsync<T>(storedProcedure, parameters, commandType: CommandType.StoredProcedure);
+        return await connection.QueryAsync<TResult>(storedProcedure, parameters, commandType: CommandType.StoredProcedure);
     }
     
-    public async Task SaveData<T>(string storedProcedure, T parameters, string connectionId = "Default")
+    public async Task SaveData<TParameter>(string storedProcedure, TParameter parameters, string connectionId = "Default")
     {
         using IDbConnection connection = new SqlConnection(_config.GetConnectionString(connectionId));