Coding Faster With .NetTips Spargine - June 2021 Release

PersonProper[] result = people.Add(person);

people.AddIf(person, people.Count() == 10);

people.Upsert(newPerson.Id, newPerson);

For Dictionary collections this is overloaded and the easiest to use if the items in your collection inherit from IDataModel.

DriveHelper

I have added the DriveHelper method from the .NET Core codebase. Here are some of the methods in this class.

GetFixedDrives()

This method returns all the fixed drives on the computer as a collection of DriveInfo.

var result = DriveHelper.GetFixedDrives();

GetRemoveableDrives()

This method returns all the removable drives connected to the computer as a collection of DriveInfo.

var result = DriveHelper.GetRemovableDrives();

FileHelper

I have added the FileHelper class from the .NET Core codebase. Here are some of the methods in this class.

CopyFile()

This method copies the file to a new directory. If the file already exists, it will be overwritten.

var result = FileHelper.CopyFile(file: fileToCopy, destinationFolder: this._tempPath);

This method returns the length of the file. The parameters for this method using FileInfo for the file and DirectoryInfo for the destination folder.

DeleteFiles()

This method attempts to delete files and will return the file name and error message for files that could not be deleted.

var result = FileHelper.DeleteFiles(filesToDelete);

DownloadFileFromWeb()

This method downloads the file from the web and stores it in the given local file path. I use this method in my free app for .NET software engineers.

const string fileToDownload = @"https://dotnettips.files.wordpress.com/dotnettips-com-logo05x1.png";
FileHelper.DownloadFileFromWeb(new Uri(fileToDownload), Path.Combine(this._tempPath.FullName, "dotNetTips.Com.logo.png"));

There is also an async version of this method too. There is also DownloadFileFromWebAndUnzipAsync() which does the same thing as DownloadFileFromWeb(), but it is for files that have been zipped and will un-zip it for you!

MoveFile()

This method moves a file from one location to another. The added value of this method is that if there is an IOException or UnauthorizedAccessExeption, it will try again for 9 more times. There are two MoveFile() methods where the second one allows you to choose how the file will be overwritten. Those choices are,

1. Replace the existing file
   If the destination file exists, the function replaces its contents with the contents of the existing file, if security requirements regarding access control lists (ACLs) are met.
   
2. Copy allowed
   If the file is to be moved to a different volume if the file is successfully copied to a different volume and the original file is unable to be deleted, the function succeeds leaving the source file intact.
   
3. Delay until reboot
   The system does not move the file until the operating system is restarted. The system moves the file immediately after AUTOCHK is executed, but before creating any paging files. Consequently, this parameter enables the function to delete paging files from previous startups. This value can be used only if the process is in the context of a user who belongs to the administrator’s group or the LocalSystem account.
   
4. Fail if not trackable
   The function fails if the source file is a link source, but the file cannot be tracked after the move. This situation can occur if the destination is a volume formatted with the FAT file system.
   
5. Write through
   The function does not return until the file is moved on the disk. Setting this value guarantees that a move performed as a copy and delete operation is flushed to the disk before the function returns. The flush occurs at the end of the copy operation.

Here is how to use this method.

FileHelper.MoveFile(file, newFile, FileMoveOptions.ReplaceExisting);

Other Methods

Other methods in FileHelper include,

1. UnGZipAsync()
   Un-GZips a file as an asynchronous operation.
   
2. UnZipAsync()
   Un-zips a file as an asynchronous operation.
   
3. UnWinZipsAsync()
   Un-WinZips a file as an asynchronous operation.

FileProcessor

The FileProcess class has methods such as CopyFiles(), DeleteFiles() and DeleteFolders() that uses events to show progress! I use this class in my free app for .NET software engineers.

CopyFiles()

This method copies a collection of files as FileInfo and sends a progress event on success and errors.

processor.Processed += this.Processor_Processed;
processor.CopyFiles(files: files, destinationFolder: new DirectoryInfo(Path.GetTempPath()));
private void Processor_Processed(object sender, FileProgressEventArgs e) {
    Debug.WriteLine(e.Message);
}

DeleteFiles()

This method deletes a collection of files as FileInfo and sends progress events on success and errors.

DeleteFolders()

This method deletes a collection of folders as DirectoryInfo and sends progress events on success and errors.

PathHelper

The PathHelper class has methods to deal with file paths for Windows. Below are some of those methods.

CombinePaths()

This method allows you to create a path from a collection of paths. The method in .NET only does two at a time.

var basePath = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);
var paths = new string[] { basePath, "Test1", "Test2", "Test3" };
var tempPath = PathHelper.CombinePaths(createIfNotExists: true, paths: paths);

This method has three overloads. Other methods include,

• EnsureTrailingSlash()
  This method makes sure your path has a backslash at the end of it.
  
• HasInvalidFilterChars()
  This method makes sure that a file search filter does not have these characters: *, | and ?.
  
• InvalidPathNameChars()
  This property returns characters not allowed in path names. There are 33 invalid characters.
  
• PathContainsWildcare()
  This method returns true if the path contains the illegal character *.
  
• PathHasInvalidChars()
  This method determines if the path has any illegal characters.
  
• PathSeparators()
  This property returns allowed path separators.

Services

Many times, in my carrier and my free app for .NET software engineers, I need to start and stop Windows services. The Services class had the following methods,

• AllServices()
  This returns a list of all the services currently on the system. When I wrote this article, I have 282 services! Here are just some of them: AdobeARMservice, AdobeUpdateService, AGMService, AGSService, DispBrokerDesktopSvc, DisplayEnhancementService, DmEnrollmentSvc, dmwappushservice, Dnscache, DoSvc, dot3svc, DPS, DsmSvc, DsSvc, DusmSvc, Eaphost, edgeupdate, edgeupdatem, EFS, embeddedmode, EntAppSvc, esifsvc, EventLog, EventSystem, Fax, fdPHost, FDResPub, fhsvc, FontCache, FontCache3.0.0.0, FrameServer
  
• ServiceExists()
  Checks to see if service exists on the system.
  
• ServiceStatus()
  Checks the service status. It will return Stopped, StartPending, StopPending, Running, ContinuePending, PausePending, and Paused.
  
• StartService()
  This method will start a service and return one of these values: NotFound, Running, Stopped, or Error.
  
• StartServices()
  This method will attempt to start multiple services with one call.
  
• StartStopServices()
  This method will attempt to start or stop multiple services with one call.
  
• StopService()
  This method will attempt to stop the service.
  
• StopServices()
  This method will attempt to stop multiple services with one call.

KeyGenerator

I moved the unique key generation code from the Tester project to the Core project. It has a method called GenerateKey() that can be used with IDs, even for CosmosDB. It returns a key like this: f7f0af78003d4ab194b5a4024d02112a. It is also overloaded so you can add a prefix to the key.

Summary

I hope you will check out these methods or any of the others in the assemblies. I am also looking for contributors to these .NET 5 projects. If you have any comments or suggestions, please comment below.