title	description	ms.date
Overview	New to C#? Learn the basics of the language. Start with this overview.	06/20/2025

A tour of the C# language

The C# language is the most popular language for the .NET platform, a free, cross-platform, open source development environment. C# programs can run on many different devices, from Internet of Things (IoT) devices to the cloud and everywhere in between. You can write apps for phone, desktop, and laptop computers and servers.

C# is a cross-platform general purpose language that makes developers productive while writing highly performant code. With millions of developers, C# is the most popular .NET language. C# has broad support in the ecosystem and all .NET workloads. Based on object-oriented principles, it incorporates many features from other paradigms, not least functional programming. Low-level features support high-efficiency scenarios without writing unsafe code. Most of the .NET runtime and libraries are written in C#, and advances in C# often benefit all .NET developers.

C# is in the C family of languages. C# syntax is familiar if you used C, C++, JavaScript, TypeScript, or Java. Like C and C++, semi-colons (;) define the end of statements. C# identifiers are case-sensitive. C# has the same use of braces, { and }, control statements like if, else and switch, and looping constructs like for, and while. C# also has a foreach statement for any collection type.

Hello world

The "Hello, World" program is traditionally used to introduce a programming language. Here it is in C#:

// This line prints "Hello, World" 
Console.WriteLine("Hello, World");

The line starting with // is a single line comment. C# single line comments start with // and continue to the end of the current line. C# also supports multi-line comments. Multi-line comments start with /* and end with */. The WriteLine method of the Console class, which is in the System namespace, produces the output of the program. This class is provided by the standard class libraries, which, by default, are automatically referenced in every C# program. Another program form requires you to declare the containing class and method for the program's entry point. The compiler synthesizes these elements when you use top-level statements.

This alternative format is still valid and contains many of the basic concepts in all C# programs. Many existing C# samples use the following equivalent format:

:::code language="csharp" interactive="try-dotnet" source="./snippets/shared/HelloWorld.cs":::

The preceding "Hello, World" program starts with a using directive that references the System namespace. Namespaces provide a hierarchical means of organizing C# programs and libraries. Namespaces contain types and other namespaces—for example, the System namespace contains many types, such as the Console class referenced in the program, and many other namespaces, such as IO and Collections. A using directive that references a given namespace enables unqualified use of the types that are members of that namespace. Because of the using directive, the program can use Console.WriteLine as shorthand for System.Console.WriteLine. In the earlier example, that namespace was implicitly included.

The Program class declared by the "Hello, World" program has a single member, the method named Main. The Main method is declared with the static modifier. While instance methods can reference a particular enclosing object instance using the keyword this, static methods operate without reference to a particular object. By convention, when there are no top-level statements a static method named Main serves as the entry point of a C# program. The class containing the Main method is typically named Program.

Tip

The examples in this article give you a first look at C# code. Some samples might show elements of C# that you're not familiar with. When you're ready to learn C#, start with our beginner tutorials, or dive into the links in each section. If you're experienced in Java, JavaScript, TypeScript, or Python, read our tips to help you find the information you need to quickly learn C#.

File-based apps

C# is a compiled language. In most C# programs, you use the dotnet build command to compile a group of source files into a binary package. Then, you use the dotnet run command to run the program. (You can simplify this process because dotnet run compiles the program before running it if necessary.) These tools support a rich language of configuration options and command-line switches. The dotnet command line interface (CLI), which is included in the .NET SDK, provides many tools to generate and modify C# files.

Beginning with C# 14 and .NET 10, you can create file-based apps, which simplifies building and running C# programs. You use the dotnet run command to run a program contained in a single *.cs file. For example, if the following code is stored in a file named hello-world.cs, you can run it by typing dotnet run hello-world.cs:

:::code language="csharp" source="./snippets/file-based-programs/hello-world.cs":::

The first line of the program contains the #! sequence (shebang) for unix shells. The location of the dotnet CLI can vary on different distributions. On any unix system, if you set the execute (+x) permission on such a C# file that contains the shebang directive, you can run the C# file directly from the command line:

./hello-world.cs

The source for these programs must be a single file, but otherwise all C# syntax is valid. You can use file-based apps for small command-line utilities, prototypes, or other experiments.

Familiar C# features

C# is approachable for beginners yet offers advanced features for experienced developers writing specialized applications. You can be productive quickly. You can learn more specialized techniques as you need them for your applications.

C# apps benefit from the .NET Runtime's automatic memory management. C# apps also use the extensive runtime libraries provided by the .NET SDK. Some components are platform independent, like file system libraries, data collections, and math libraries. Others are specific to a single workload, like the ASP.NET Core web libraries, or the .NET MAUI UI library. A rich Open Source ecosystem on NuGet augments the libraries that are part of the runtime. These libraries provide even more components you can use.

C# is a strongly typed language. Every variable you declare has a type known at compile time. The compiler, or editing tools tell you if you're using that type incorrectly. You can fix those errors before you ever run your program. Fundamental data types are built into the language and runtime: value types like int, double, char, reference types like string, arrays, and other collections. As you write your programs, you create your own types. Those types can be struct types for values, or class types that define object-oriented behavior. You can add the record modifier to either struct or class types so the compiler synthesizes code for equality comparisons. You can also create interface definitions, which define a contract, or a set of members, that a type implementing that interface must provide. You can also define generic types and methods. Generics use type parameters to provide a placeholder for an actual type when used.

As you write code, you define functions, also called methods, as members of struct and class types. These methods define the behavior of your types. Methods can be overloaded, with different number or types of parameters. Methods can optionally return a value. In addition to methods, C# types can have properties, which are data elements backed by functions called accessors. C# types can define events, which allow a type to notify subscribers of important actions. C# supports object oriented techniques such as inheritance and polymorphism for class types.

C# apps use exceptions to report and handle errors. This practice is familiar if you used C++ or Java. Your code throws an exception when it can't do what was intended. Other code, no matter how many levels up the call stack, can optionally recover by using a try - catch block.

Distinctive C# features

Some elements of C# might be less familiar.

C# provides pattern matching. Those expressions enable you to inspect data and make decisions based on its characteristics. Pattern matching provides a great syntax for control flow based on data. The following code shows how methods for the boolean and, or, and xor operations could be expressed using pattern matching syntax:

:::code language="csharp" source="./snippets/shared/PatternMatching.cs" id="PatternExamples":::

Pattern matching expressions can be simplified using _ as a catch all for any value. The following example shows how you can simplify the and method:

:::code language="csharp" source="./snippets/shared/PatternMatching.cs" id="ReducedPattern":::

The preceding examples also declare tuples, lightweight data structures. A tuple is an ordered, fixed-length sequence of values with optional names and individual types. You enclose the sequence in ( and ) characters. The declaration (left, right) defines a tuple with two boolean values: left and right. Each switch arm declares a tuple value such as (true, true). Tuples provide convenient syntax to declare a single value with multiple values.

Collection expressions provide a common syntax to provide collection values. You write values or expressions between [ and ] characters and the compiler converts that expression to the required collection type:

:::code language="csharp" source="./snippets/shared/CollectionExpressions.cs" id="CollectionExpressions":::

The previous example shows different collection types that can be initialized using collection expressions. One example uses the [] empty collection expression to declare an empty collection. Another example uses the .. spread element to expand a collection and add all its values to the collection expression.

You can use index and range expressions to retrieve one or more elements from an indexable collection:

:::code language="csharp" source="./snippets/shared/CollectionExpressions.cs" id="RangeAndIndex":::

The ^ index indicates from the end rather than from the start. The ^0 element is one past the end of the collection, so ^1 is the last element. The .. in a range expression denotes the range of elements to include. The range starts with the first index and includes all elements up to, but not including, the element at the last index.

For more information about index and range expressions, see the Explore indexes and ranges article.

Language integrated query (LINQ) provides a common pattern-based syntax to query or transform any collection of data. LINQ unifies the syntax for querying in-memory collections, structured data like XML or JSON, database storage, and even cloud based data APIs. You learn one set of syntax and you can search and manipulate data regardless of its storage. The following query finds all students whose grade point average is greater than 3.5:

:::code language="csharp" source="./snippets/shared/LinqExample.cs" id="LinqExampleQuery":::

The preceding query works for many storage types represented by Students. It could be a collection of objects, a database table, a cloud storage blob, or an XML structure. The same query syntax works for all storage types.

The Task based asynchronous programming model enables you to write code that reads as though it runs synchronously, even though it runs asynchronously. It utilizes the async and await keywords to describe methods that are asynchronous, and when an expression evaluates asynchronously. The following sample awaits an asynchronous web request. When the asynchronous operation completes, the method returns the length of the response:

:::code language="csharp" source="./snippets/shared/AsyncSamples.cs" id="GetPageLengthAsync":::

C# also supports an await foreach statement to iterate a collection backed by an asynchronous operation, like a GraphQL paging API. The following sample reads data in chunks, returning an iterator that provides access to each element when it's available:

:::code language="csharp" source="./snippets/shared/AsyncSamples.cs" id="ReadDataAsync":::

Callers can iterate the collection using an await foreach statement:

:::code language="csharp" source="./snippets/shared/AsyncSamples.cs" id="UseReadSequence":::

Finally, as part of the .NET ecosystem, you can use Visual Studio, or Visual Studio Code with the C# DevKit. These tools provide rich understanding of C#, including the code you write. They also provide debugging capabilities.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!