Add new file handling features and update dependencies

Modified `using` directives in `FileResult.cs` to remove `Telegram.Bot` and `Telegram.Bot.Types`, and add `TelegramBot.Abstractions`.

Added a new constructor to `FileResult` class in `FileResult.cs` to create an instance using a `Stream`, `fileName`, and `disposeStream` flag.

Updated `Dispose` method in `FileResult` class to check `_disposeStream` flag before disposing of the file stream.

Added `File` method in `BotControllerBase.cs` to send a file to the sender, with a `filePath` parameter and `ArgumentNullException` for null or empty `filePath`.

Author: bvdcode

Sources/TelegramBot/ActionResults/FileResult.cs

@@ -1,8 +1,8 @@
 using System;
 using System.IO;
-using System.Threading.Tasks;
 using Telegram.Bot;
 using Telegram.Bot.Types;
+using System.Threading.Tasks;
 using TelegramBot.Abstractions;
 
 namespace TelegramBot.ActionResults
@@ -27,12 +27,25 @@ public FileResult(string filePath)
             _fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
         }
 
+        /// <summary>
+        /// Creates a new instance of <see cref="FileResult"/>.
+        /// </summary>
+        /// <param name="stream">Stream with file content.</param>
+        /// <param name="fileName">File name.</param>
+        /// <param name="disposeStream">Dispose the stream after sending the file.</param>
+        public FileResult(Stream stream, string fileName, bool disposeStream = true)
+        {
+            _fileName = fileName;
+            _fileStream = stream;
+            _disposeStream = disposeStream;
+        }
+
         /// <summary>
         /// Disposes the file stream if it is applicable.
         /// </summary>
         public void Dispose()
         {
-            if (!_disposed)
+            if (!_disposed && _disposeStream)
             {
                 _fileStream.Dispose();
                 _disposed = true;

Sources/TelegramBot/Controllers/BotControllerBase.cs

@@ -96,6 +96,12 @@ public IActionResult Void()
             return new EmptyResult();
         }
 
+        /// <summary>
+        /// Sends a file to the sender.
+        /// </summary>
+        /// <param name="filePath">Path to the file.</param>
+        /// <returns>Result of the <see cref="IActionResult"/> action.</returns>
+        /// <exception cref="ArgumentNullException">Thrown when <paramref name="filePath"/> is null or empty.</exception>
         public IActionResult File(string filePath)
         {
             if (string.IsNullOrWhiteSpace(filePath))