API for file management

/* Create a unique ID for the new file. */
Guid fileId = Guid.NewGuid(); 
/* Create a file locator for the new file. */
var fileLocator= new EntityFileLocator("ActivityFile", fileId); 
/* Get an IFile object for the new file. */ 
IFile file = UserConnection.CreateFile(fileLocator); 
/* There is no file metadata or file content in the available file storages. Specify the file name in the file metadata. */
file.Name = "New file"; 
/* Set an attribute for the new file: bind the file to an Activity record with the activityId key. This is file metadata as well. */
file.SetAttribute("ActivityId", activityId); 
/* Save the file metadata Do this BEFORE saving the content. */
file.Save(); 
/* byte[] content – this is the file contents. */
var content = new byte[] {0x12, 0x34, 0x56}; 
using (var stream = new MemoryStream(content)) { 
    /* Save the content to the database. FileWriteOptions.SinglePart implies that the contents will be transferred without breaking into smaller parts. */
    file.Write(stream, FileWriteOptions.SinglePart); 
}

using Terrasoft.Common;

var content = new byte[]();
Guid recordId = Guid.NewGuid();

/* Create a file locator for the new file. */
var fileLocator = new EntityFileLocator("ActivityFile", recordId);
IFile file = UserConnection.GetFile(fileLocator);

/* Read the contents of the file in the content byte array. Remember to free the stream object by utilizing using! */
using (Stream stream = file.Read()) {
   content = stream.ReadToEnd();
}

var content = new byte[](); 
/* Get the file with the file locator. */
var fileLocator = new EntityFileLocator("ActivityFile", fileId); 
IFile file = UserConnection.GetFile(fileLocator); 
/* Read the contents of the file in the content byte array. Remember to free the stream object by utilizing using! */
using (Stream stream = file.Read()) { 
    content = stream.ReadToEnd(); 
} 
/* Copy the file. */ 
  
/* Create a new IFile to copy the current file. */ 
Guid copyFileId = Guid.NewGuid();
var copyFileLocator = new EntityFileLocator("ActivityFile", copyFileId);
IFile copyFile = UserConnection.CreateFile(copyFileLocator); 
copyFile.Name = file.Name + " - Copy"; 
copyFile.Save(); 
  
/* Copy the contents of the first file to the new file. */ 
copyFile.Write(new MemoryStream(content), FileWriteOptions.SinglePart); 
  
/* An alternate way to copy the file. */
file.Copy(copyFile); 
  
/* Move the file. */
  
/* Create a new file to copy the current file. */ 
Guid moveFileId = Guid.NewGuid();
var moveFileLocator = new EntityFileLocator("ContactFile", moveFileId); IFile moveFile = UserConnection.CreateFile(moveFileLocator); 
moveFile.Save(); 
  
/* Move to the new location. */ 
file.Move(moveFile); 
  
/* Delete the original file. */
file.Delete();

namespace Terrasoft.Configuration
{
   using System.IO;
   using System.Threading.Tasks;
   using Terrasoft.File.Abstractions;
   using Terrasoft.File.Abstractions.Content;
   using Terrasoft.File.Abstractions.Metadata;
   using Terrasoft.File.Metadata;
 
   /// <summary>
   /// Content storage in the file system.
   /// </summary>
   public class FsFileBlobStorage : IFileContentStorage
   {
       
      // A root path to the storage.
      private const string BaseFsPath = "C:\\FsStore\\";
       
      private static string GetPath(FileMetadata fileMetadata) {
         var md = (EntityFileMetadata)fileMetadata;
         string key = $"{md.EntitySchemaName}\\{md.RecordId}_{fileMetadata.Name}";
         return Path.Combine(BaseFsPath, key);
      }
 
      public Task<Stream> ReadAsync(IFileContentReadContext context) {
         string filePath = GetPath(context.FileMetadata);
         Stream stream = System.IO.File.OpenRead(filePath);
         return Task.FromResult(stream);
      }
 
      public async Task WriteAsync(IFileContentWriteContext context) {
         string filePath = GetPath(context.FileMetadata);
         FileMode flags = context.WriteOptions != FileWriteOptions.SinglePart
            ? FileMode.Append
            : FileMode.OpenOrCreate;
         string dirPath = Path.GetDirectoryName(filePath);
         if (!Directory.Exists(dirPath)) {
            Directory.CreateDirectory(dirPath);
         }
         using (var fileStream = System.IO.File.Open(filePath, flags)) {
            context.Stream.CopyToAsync(fileStream);
         }
      }
       
      public Task DeleteAsync(IFileContentDeleteContext context) {
         string filePath = GetPath(context.FileMetadata);
         System.IO.File.Delete(filePath);
         return Task.CompletedTask;
      }
       
      public Task CopyAsync(IFileContentCopyMoveContext context) {
         string sourceFilePath = GetPath(context.SourceMetadata);
         string targetFilePath = GetPath(context.TargetMetadata);
         System.IO.File.Copy(sourceFilePath, targetFilePath);
         return Task.CompletedTask;
      }
       
      public Task MoveAsync(IFileContentCopyMoveContext context) {
         string sourceFilePath = GetPath(context.SourceMetadata);
         string targetFilePath = GetPath(context.TargetMetadata);
         System.IO.File.Move(sourceFilePath, targetFilePath);
         return Task.CompletedTask;
      }
   }
}