📉Files - NKS0013

Use Making.MakeDirectory()

This analyzer provides the following strings:

Context
String

Error List

Caller uses Directory.CreateDirectory instead of Making.MakeDirectory()

Suggestion Box

Use Making.MakeDirectory() instead of Directory.CreateDirectory

Description

Making.MakeDirectory() neutralizes the provided path to its absolute correct path, while Directory.CreateDirectory operates at the executable directory (Environment.CurrentDirectory), which may not be what you want.

Extended Description

This code analyzer detects the usage of CreateDirectory from the standard Directory class found in the System.IO namespace.

Using Directory.CreateDirectory(), path neutralization doesn't take place to ensure that we have the correct absolute path. This causes some of the filesystem operations to operate on files, which are located in the wrong place, and, therefore, errors throw about a target not being found.

A solution to this problem was made with MakeDirectory(), because it takes care of the absolute paths and tries to reduce this kind of error caused by passing relative directories to the arguments.

Analysis Comparison

To get a brief insight about how this analyzer works, compare the two code blocks shown to you below:

Before the fix

Somewhere in your mod code...
public static void MyFunction()
{
    Directory.CreateDirectory("test");
}

After the fix

Somewhere in your mod code...
public static void MyFunction()
{
    Making.MakeDirectory("test");
}

Suppression

You can suppress this suggestion by including it in the appropriate place, whichever is convenient.

For more information about how to suppress any warning issued by the Nitrocid analyzer, visit the below page:

Recommendation

We recommend that every caller which use this function use the recommended abovementioned method.

Last updated