Skip to main content

Ignoring Code

Use .csharpierignore to bypass formatting specific files and folders.

Use csharpier-ignore comments to bypass formatting specific parts of files.

Ignoring Files .csharpierignore

Add a .csharpierignore file to ignore additional files and folders. The file uses gitignore syntax

Example

Uploads/
**/App_Data/*.cs

Files Ignored by Default

Csharpier will ignore the following files

SDK Generated Files

See Configuration for including these files

  • Any file that begins with TemporaryGeneratedFile_
  • Any file that ends with .designer.cs
  • Any file that ends with .generated.cs
  • Any file that ends with .g.cs
  • Any file that ends with .g.i.cs
  • Any file that begins with a comment that contains <autogenerated or <auto-generated

Node Module Files

  • Any file that matches the gitignore syntax **/node_modules/**/*.cs

Ignoring Code

Add a // csharpier-ignore comment to exclude the next node from formatting. This is valid on statements and members.


// csharpier-ignore
public class Unformatted     { 
        private string     unformatted;
}

public class ClassName
{
    // csharpier-ignore
    private string    unformatted;

    // csharpier-ignore
    public void MethodName(      ) {
        var unformatted =     "";
    }

    public void MethodName()
    {
        // csharpier-ignore
        var unformatted    = true;

        if (true)
        {
            // csharpier-ignore
            var unformatted    = true;
        }
    }
}

Use a ranged ignore to exclude multiple lines from formatting. A range is valid around statements and members.

// csharpier-ignore-start
public class Unformatted1     { }
public class Unformatted2     { }
// csharpier-ignore-end

public class ClassName
{
    // csharpier-ignore-start
    private string    unformatted1;
    private string    unformatted2;
    public void MethodName(      ) {
            var unformatted =     "";
    }
    // csharpier-ignore-end
    public void MethodName()
    {
        // csharpier-ignore-start
        var unformatted1    = true;
        var unformatted2    = true;
        if (false)     {
            return;
        }
        // csharpier-ignore-end
        if (true)
        {
            // csharpier-ignore-start
            var unformatted3    = true;
            var unformatted4    = true;
            // csharpier-ignore-end
            
            var formatted = true;
        }
    }
}

As of 0.23.0 both types of ignores can include a description as part of the comment. The description must be seperated from the comment by at least one - character.

// csharpier-ignore - class copied as-is from another project
public class Unformatted     { 
        private string     unformatted;
}

// csharpier-ignore-start -- class copied as-is from another project
public class Unformatted1     { }
public class Unformatted2     { }
// csharpier-ignore-end