Add comment

Add comment

Author: JonathanMagnan

EntityFrameworkExtras.Shared/DatabaseExtensions.cs

@@ -122,6 +122,14 @@ private static object GetValue(this DbDataReader reader, string name)
 	        return val;
         }
 
+        /// <summary>
+        /// Executes the specified stored procedure against a database
+        /// and returns the first or default value
+        /// </summary>
+        /// <typeparam name="T">Type of the data returned from the stored procedure.</typeparam>
+        /// <param name="database">The database to execute against.</param>
+        /// <param name="storedProcedure">The stored procedure to execute.</param>
+        /// <returns></returns>
         public static T ExecuteStoredProcedureFirstOrDefault<T>(this DatabaseFacade database, object storedProcedure)
         {
             return database.ExecuteStoredProcedure<T>(storedProcedure).FirstOrDefault();
@@ -134,13 +142,22 @@ public static IEnumerable<T> ExecuteStoredProcedure<T>(this Database database, o
 
             var info = StoredProcedureParser.BuildStoredProcedureInfo(storedProcedure);
 
-            // need resolution for info.SqlParameters when a paramater have direction output.
+            // TODO: need resolution for info.SqlParameters when a paramater have direction output.
             List<T> result = database.SqlQuery<T>(info.Sql, info.SqlParameters).ToList();
 
             SetOutputParameterValues(info.SqlParameters, storedProcedure);
 
             return result;
         }
+
+        /// <summary>
+        /// Executes the specified stored procedure against a database
+        /// and returns the first or default value
+        /// </summary>
+        /// <typeparam name="T">Type of the data returned from the stored procedure.</typeparam>
+        /// <param name="database">The database to execute against.</param>
+        /// <param name="storedProcedure">The stored procedure to execute.</param>
+        /// <returns></returns>
         public static T ExecuteStoredProcedureFirstOrDefault<T>(this Database database, object storedProcedure)
         {
             return database.ExecuteStoredProcedure<T>(storedProcedure).FirstOrDefault();

EntityFrameworkExtras.Shared/StoredProcedureParameterAttribute.cs

@@ -56,12 +56,13 @@ public StoredProcedureParameterAttribute(SqlDbType dataType, StoredProcedurePara
         /// </summary>
         public string ParameterName { get; set; }
 
+        /// <summary>Gets or sets the direction.</summary>
         public ParameterDirection Direction { get; set; } 
 
-        // NEED TEXT!
-        public byte Precision { get; set; } 
+        /// <summary>Gets or sets the parameter precision.</summary>
+        public byte Precision { get; set; }
 
-        // NEED TEXT!
+        /// <summary>Gets or sets the parameter scale.</summary>
         public byte Scale { get; set; }
     }
 }