How To Create Net Core Project In Visual Studio Code

Author avatar

Developing .NET Core Apps with Visual Studio Code

Douglas Starnes

Languages Frameworks and Tools

Introduction

Five years ago, Microsoft announced what eventually became .NET Core, an open-source and cross-platform implementation of .NET. This brought C# and .NET to macOS and Linux. One of the traits of .NET Core is that in addition to being platform-independent, the framework is also tool-independent. But this could result in varying development experiences. Microsoft's answer to this problem is Visual Studio Code, a text editor inspired by Microsoft's flagship Visual Studio. When you choose Visual Studio Code for .NET Core development, you get a consistent cross-platform developer experience on Windows, macOS and Linux.

Extensions

The .NET Core development experience is powered by the C# extension available from the Visual Studio Code Marketplace. To get the extension, press Ctrl-Shift-X / Cmd-Shift-X (all keyboard shortcuts in this guide are for macOS) to open the Extensions pane. In the search bar, search for "C#". Install the extension from Microsoft by clicking Install.

the C# extension

Also, install the C# Extensions extension. This adds a few shortcuts such as scaffolding new classes and interfaces. It's not under active development anymore, but it's still relevant.

More extensions will be introduced later on.

The Terminal

Visual Studio Code does not have a fancy user interface like Visual Studio does on Windows or macOS. There is no File -> New Project option. Therefore, in Visual Studio Code, .NET Core development makes heavy use of the command line. Press Ctrl-Backtick to open and close the terminal.

To create the demo app for this guide, run the dotnet command in the terminal.

                                      1                    $ dotnet new console -o GuideDemoApp

This will create a new .NET Core console project named GuideWebApp in a new directory called GuideDemoApp . Restart Visual Studio Code and open the GuideDemoApp project.

Editing

First, you need to write some code to run. This example begins with creating a user management app, or at least a portion of one. The one thing it needs it a user class. The C# Extensions extension adds many features to the editor. Right-click in the Explorer pane and select New Class. In the command palette, enter the filename DemoUser.cs . This will scaffold a class named User in an appropriate namespace. The class will have two public properties. You can generate these using code snippets similar to Visual Studio. Type the snippet prop and press the tab key.

prop snippet

This generates an auto-implemented property. Notice that the type is highlighted so you can start typing string to change it. Press tab again to highlight the name of the property and change it to Username . Repeat the process to create another property of type string named Password .

Finally, override the ToString method to render an instance of the class.

                                      1                    public                                                            override                                                            string                                                            ToString                    (                    )                                                            2                                        {                                                            3                                                            return                                                            $"<User:                                        {                    Username                    }                                          /                                        {                    Password                    }                    >"                    ;                                                            4                                        }

csharp

Press Ctrl-P / Cmd-P and start typing the name of the file, Program.cs . Visual Studio Code will filter the files as you. Press Enter to open Program.cs once it is highlighted.

quick file open

In the Main method, create a new User and write it to the console.

                                      1                    var                                          user                                        =                                                            new                                                            DemoUser                    (                    )                    ;                                                            2                    user                    .

csharp

Just like in Visual Studio, Visual Studio Code displays a list of valid completions after the dot.

intellisense

                                      1                    var                                          user                                        =                                                            new                                                            DemoUser                    (                    )                    ;                                                            2                    user                    .                    Username                                        =                                                            "jdoe"                    ;                                                            3                    user                    .                    Password                                        =                                                            "abcxyz"                    ;

csharp

It looks like "jdoe" is not in the habit of creating strong passwords. To help them out, add a method to the User class that returns a string named GeneratePassword . Assume a strong password is at least one uppercase character followed by at least one digit separated by a dash. The total length (excluding the dash) should be at least eight characters. Since the method will join strings, use the StringBuilder class.

                                      1                    public                                                            string                                                            GeneratePassword                    (                    int                                          numChars                    .                    =                                                            4                    ,                                                            int                                          numDigits                                        =                                                            4                    )                                                            2                                        {                                                            3                                                            var                                          password                                        =                                                            new                                                            StringBuilder                    (                    )                    ;                                                            4                                        }

csharp

Visual Studio Code draws a wavy line under StringBuilder because it cannot be found. Place the cursor on StringBuilder , press Ctrl-. / Cmd-., and choose using System.Text from the pop up menu to automatically insert the System.Text namespace and resolve the error.

namespace quick fix

Working with NuGet Packages

To help generate random passwords, you can use a NuGet package called Bogus. Adding NuGet packages is easy with another extension named NuGet Gallery. Go ahead and install it.

After installation, open the command palette and search for "NuGet: Open Gallery." You'll see an interface similar to Visual Studio for managing NuGet packages. Search for "Bogus." On the right side, click the Install link next to GuideDemoApp.csproj.

nuget gallery extension

Back in the DemoUser class, finish off the GeneratePassword method. Remember to use the shortcut to add the Bogus namespace for the Randomizer class.

                                      1                    var                                          randomizer                                        =                                                            new                                                            Randomizer                    (                    )                    ;                                                            2                    password                    .                    Append                    (                    randomizer                    .                    String                    (                    numChars                    ,                                          numChars                    ,                                          Convert                    .                    ToChar                    (                    65                    )                    ,                                          Convert                    .                    ToChar                    (                    90                    )                    )                    )                    ;                                                            3                    password                    .                    Append                    (                    "-"                    )                    ;                                                            4                    password                    .                    Append                    (                    randomizer                    .                    String                    (                    numDigits                    ,                                          numDigits                    ,                                          Convert                    .                    ToChar                    (                    48                    )                    ,                                          Convert                    .                    ToChar                    (                    57                    )                    )                    )                    ;                                                            5                                        return                                          password                    .                    ToString                    (                    )                    ;

csharp

Now you can update the code to create a new User in Program.cs . The Person class can also be found in the Bogus namespace.

                                      1                    var                                          bogusPerson                                        =                                                            new                                                            Person                    (                    )                    ;                                                            2                    user                    .                    Username                                        =                                                            (                    bogusPerson                    .                    FirstName                    [                    0                    ]                                                            +                                          bogusPerson                    .                    LastName                    )                    .                    ToLower                    (                    )                    ;                                                            3                    user                    .                    Password                                        =                                          user                    .                    GeneratePassword                    (                    )                    ;

csharp

To run the app, add the following code to the end of the Main method:

                                      1                    Console                    .                    Writeline                    (                    user                    .                    ToString                    (                    )                    )                    ;

csharp

the generated user

Conclusion

Visual Studio Code is not "Visual Studio Lite." It is a professional-caliber development tool. What you saw here is just a fraction of what the editor can do and the extensions that it supports. The screenshots in this guide were from macOS, but everything shown will still work on Windows and even Linux.

For more on developing .NET Core apps with Visual Studio Code check out: