JetBrains Rider 2021.3 Help

Predefined Live Templates for C#

This topic lists all predefined live templates for C# in JetBrains Rider 2021.3. For more information about live templates, see Create source code using live templates

Template

Details

ctx

Current file context

Scope everywhere

Body

$CTX$

Parameters

  • CTX - Provides list of items describing current context. This includes file name, containing type name, namespace name, etc.

This could be useful:

  • In string literals that contain references to the current context, that is Logger.LogError("Cannot find action ActionNameDerivedFromContext");

  • As an alternative to code completion where IntelliSense doesn't work properly - for example, in comments when documenting a member with a long name (see example below).

Before expansion

JetBrains Rider: Live templates
Expansion options
JetBrains Rider: Live templates

nguid

Insert new GUID

Scope everywhere

Body

$GUID$

Parameters

  • GUID - Generates new Globally Unique Identifier (GUID)

join

Join clause in language integrated query

Scope C# 2.0+ queries

Body

join $NAME$ in $COL$ on $EXPR1$ equals $EXPR2$ $END$

Parameters

  • COL - Suggests variables of the specified type.

  • NAME - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • EXPR1 - no macro

  • EXPR2 - no macro

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

from

Language-Integrated Query

Scope C# 3.0+ expressions, C# 3.0+ queries

Body

from $VAR$ in $COLLECTION$ $END$

Parameters

  • COLLECTION - Suggests variables of the specified type.

  • VAR - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

foreach

foreach block

Scope C# 2.0+ statements

Body

foreach ($TYPE$ $VARIABLE$ in $COLLECTION$) { $SELECTION$$END$ }

Parameters

  • COLLECTION - Show basic code completion list at the point where the variable is evaluated

  • TYPE - Suggest type for a new variable declared in the template

  • VARIABLE - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • SELECTION - The text selected by the user before invoking the template.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

After you specify the parameters, the caret is positioned so that you can continue coding the loop body.

itli

Iterate a IList<T>

Scope C# 2.0+ statements

Body

for (int $INDEX$ = 0; $INDEX$ < $LIST$.Count; $INDEX$++) { $TYPE$ $ITEM$ = $LIST$[$INDEX$]; $END$ }

Parameters

  • INDEX - Suggests non-used name which can be used for an index variable at the evaluation point.

  • LIST - Suggests variables of the specified type.

  • TYPE - Suggest type for a new variable declared in the template

  • ITEM - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

The template generates a for loop which iterates over an instance of System.Collections.IList. Includes a customizable statement in the loop body with a variable holding container elements.

After you specify the parameters, the caret is positioned so that you can continue coding the loop body.

itar

Iterate an array

Scope C# 2.0+ statements

Body

for (int $INDEX$ = 0; $INDEX$ < $ARRAY$.Length; $INDEX$++) { $TYPE$ $VAR$ = $ARRAY$[$INDEX$]; $END$ }

Parameters

  • INDEX - Suggests non-used name which can be used for an index variable at the evaluation point.

  • ARRAY - Suggests variable which type is array type

  • TYPE - Suggest type for a new variable declared in the template

  • VAR - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

After you specify the parameters, the caret is positioned so that you can continue coding the loop body.

ritar

Iterate an array in inverse order

Scope C# 2.0+ statements

Body

for (int $INDEX$ = $ARRAY$.Length - 1; $INDEX$ >= 0; $INDEX$--) { $TYPE$ $VAR$ = $ARRAY$[$INDEX$]; $END$ }

Parameters

  • INDEX - Suggests non-used name which can be used for an index variable at the evaluation point.

  • ARRAY - Suggests variable which type is array type

  • TYPE - Suggest type for a new variable declared in the template

  • VAR - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

The template generates a for loop for iterating over an array in reverse order. Includes a customizable statement in the loop body with a variable holding container elements.

After you specify the parameters, the caret is positioned so that you can continue coding the loop body.

for

Simple "for" loop

Scope C# 2.0+ statements

Body

for (int $INDEX$ = 0; $INDEX$ < $UPPER$; $INDEX$++) { $SELECTION$$END$ }

Parameters

  • INDEX - Suggests non-used name which can be used for an index variable at the evaluation point.

  • UPPER - no macro

  • SELECTION - The text selected by the user before invoking the template.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

After you specify the parameters, the caret is positioned so that you can continue coding the loop body.

sfc

Safely cast variable

Scope C# 2.0+ statements

Body

$VARTYPE$ $VAR$ = $VAR1$ as $TYPE$; if ($VAR$ != null) { $END$ }

Parameters

  • VAR1 - Suggests variables of the specified type.

  • TYPE - no macro

  • VARTYPE - Suggest type for a new variable declared in the template

  • VAR - When executed in variable declaration (where variable name should stand), suggests name for the variable.

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

psvm

The "Main" method declaration

Scope C# 2.0+ type members

Body

public static void Main( string[] args ) { $END$ }

Parameters

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

outv

Print value of a variable

Scope C# 2.0+ statements

Body

System.Console.Out.WriteLine("$EXPR$ = {0}", $EXPR$);

Parameters

  • EXPR - Suggests variables of the specified type.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

ReSharper automatically suggests a list of all variables in the current scope and, by default, selects the most recently declared one. The descriptive text string (s = in the example above) is automatically synchronized with the name of the selected variable.

out

Print a string

Scope C# 2.0+ statements

Body

System.Console.Out.WriteLine("$END$");

Parameters

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

asrt

Make an assertion

Scope C# 2.0+ statements

Body

System.Diagnostics.Debug.Assert($END$);

Parameters

  • END - The caret position after the template is applied.

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

This template calls the Debug.Assert method, which is used for debugging purposes. After the template expanded, the caret moves between the parentheses so that you can specify a condition.

asrtn

Assert expression not null

Scope C# 2.0+ statements

Body

System.Diagnostics.Debug.Assert($EXPR$ != null, "$MESSAGE$");

Parameters

  • EXPR - no macro

  • MESSAGE - no macro

Before expansion

JetBrains Rider: Live templates
After expansion
JetBrains Rider: Live templates

The template inserts the Debug.Assert method, which checks a condition and displays a message if the condition is false.

thr

throw new

Scope C# 2.0+ statements

Body

throw new

    Before expansion

    JetBrains Rider: Live templates
    After expansion
    JetBrains Rider: Live templates

    pci

    public const int

    Scope C# 2.0+ type members

    Body

    public const int

      Before expansion

      JetBrains Rider: Live templates
      After expansion
      JetBrains Rider: Live templates

      pcs

      public const string

      Scope C# 2.0+ type members

      Body

      public const string

        Before expansion

        JetBrains Rider: Live templates
        After expansion
        JetBrains Rider: Live templates

        psr

        public static readonly

        Scope C# 2.0+ type members

        Body

        public static readonly

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          prop

          Property

          Scope C# 2.0+ type members

          Body

          public $TYPE$ $NAME$ { get; set; }

          Parameters

          • TYPE - no macro

          • NAME - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          ear

          Create an empty array

          Scope C# 2.0+ statements

          Body

          $TYPE$[] $NAME$ = new $TYPE$[] {};

          Parameters

          • TYPE - no macro

          • NAME - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          #if

          Scope C# 2.0+ except strings, at line start

          Body

          #if $expression$ $SELECTION$$END$ #endif

          Parameters

          • expression - Evaluates to the specified constant value.

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          #region

          Scope C# 2.0+ except strings, at line start

          Body

          #region $name$ $SELECTION$$END$ #endregion

          Parameters

          • name - Evaluates to the specified constant value.

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          enum

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          enum $name$ { $END$ }

          Parameters

          • name - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          else

          else statement

          Scope C# 2.0+ statements

          Body

          else { $END$ }

          Parameters

          • END - The caret position after the template is applied.

          ~

          Destructor

          Scope C# 2.0+ type members

          Body

          ~$classname$() { $END$ }

          Parameters

          • classname - Evaluates to short name of the most inner containing type.

          • END - The caret position after the template is applied.

          ctor

          Constructor

          Scope C# 2.0+ type members

          Body

          public $classname$ () { $END$ }

          Parameters

          • classname - Evaluates to short name of the most inner containing type.

          • END - The caret position after the template is applied.

          cw

          Console.WriteLine

          Scope C# 2.0+ statements

          Body

          System.Console.WriteLine($END$);

          Parameters

          • END - The caret position after the template is applied.

          class

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          class $name$ { $END$ }

          Parameters

          • name - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          Exception

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          [System.Serializable] public class $newException$Exception : System.Exception { // // For guidelines regarding the creation of new exception types, see // http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconerrorraisinghandlingguidelines.asp // and // http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dncscol/html/csharp07192001.asp // public $newException$Exception() { } public $newException$Exception( string message ) : base( message ) { } public $newException$Exception( string message, System.Exception inner ) : base( message, inner ) { } protected $newException$Exception( System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context ) : base( info, context ) { } }

          Parameters

          • newException - Evaluates to the specified constant value.

          struct

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          struct $name$ { $END$ }

          Parameters

          • name - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          forr

          Reverse 'for' loop

          Scope C# 2.0+ statements

          Body

          for (int $index$ = $max$ - 1; $index$ >= 0 ; $index$--) { $END$ }

          Parameters

          • index - Evaluates to the specified constant value.

          • max - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          namespace

          Scope C# 2.0+ types and namespaces

          Body

          namespace $name$ { $END$$SELECTION$ }

          Parameters

          • name - Evaluates to the specified constant value.

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          interface

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          interface I$name$ { $END$ }

          Parameters

          • name - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          sim

          'int Main' method

          Scope C# 2.0+ type members

          Body

          static int Main(string[] args) { $END$ return 0; }

          Parameters

          • END - The caret position after the template is applied.

          indexer

          Scope C# 2.0+ type members

          Body

          $access$ $type$ this[$indextype$ index] { get {$END$ /* return the specified index here */ } set { /* set the specified index to value here */ } }

          Parameters

          • access - Evaluates to the specified constant value.

          • type - Evaluates to the specified constant value.

          • indextype - Evaluates to the specified constant value.

          • END - The caret position after the template is applied.

          svm

          'void Main' method

          Scope C# 2.0+ type members

          Body

          static void Main(string[] args) { $END$ }

          Parameters

          • END - The caret position after the template is applied.

          unsafe

          unsafe statement

          Scope C# 2.0+ statements

          Body

          unsafe { $END$ }

          Parameters

          • END - The caret position after the template is applied.

          unchecked

          unchecked block

          Scope C# 2.0+ statements

          Body

          unchecked { $END$ }

          Parameters

          • END - The caret position after the template is applied.

          tryf

          try finally

          Scope C# 2.0+ statements

          Body

          try { $SELECTION$ } finally { $END$ }

          Parameters

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          try

          try catch

          Scope C# 2.0+ statements

          Body

          try { $SELECTION$ } catch ($EXCEPTION$ $EX_NAME$) { $SELSTART$System.Console.WriteLine($EX_NAME$); throw;$SELEND$ }

          Parameters

          • EXCEPTION - Evaluates to the specified constant value.

          • EX_NAME - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          • SELECTION - The text selected by the user before invoking the template.

          switch

          switch statement

          Scope C# 2.0+ statements

          Body

          switch ($expression$) { $END$ }

          Parameters

          • expression - Suggests variables of the specified type.

          • END - The caret position after the template is applied.

          while

          while loop

          Scope C# 2.0+ statements

          Body

          while ($expression$) { $SELECTION$$END$ }

          Parameters

          • expression - Show basic code completion list at the point where the variable is evaluated

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          iterator

          simple iterator

          Scope C# 2.0+ type members

          Body

          public $SystemCollectionsGenericIEnumeratorG$<$type$> GetEnumerator() { $SELSTART$throw new System.NotImplementedException(); yield return default($type$); $SELEND$ }

          Parameters

          • type - Evaluates to the specified constant value.

          • SystemCollectionsGenericIEnumeratorG - Evaluates to the specified constant value.

          propg

          Property with a 'get' accessor and a private 'set' accessor

          Scope C# 2.0+ type members

          Body

          public $type$ $property$ { get; private set; }

          Parameters

          • type - Evaluates to the specified constant value.

          • property - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          Attribute

          Attribute using recommended pattern

          Scope C# 2.0+ type members, C# 2.0+ types and namespaces

          Body

          [System.AttributeUsage(System.AttributeTargets.$target$, Inherited = $inherited$, AllowMultiple = $allowmultiple$)] sealed class $name$Attribute : System.Attribute { // See the attribute guidelines at // http://go.microsoft.com/fwlink/?LinkId=85236 public $name$Attribute () { $SELSTART$// TODO: Implement code here throw new System.NotImplementedException();$SELEND$ } }

          Parameters

          • name - Evaluates to the specified constant value.

          • target - Evaluates to the specified constant value.

          • inherited - Evaluates to the specified constant value.

          • allowmultiple - Evaluates to the specified constant value.

          do

          do...while loop

          Scope C# 2.0+ statements

          Body

          do { $SELECTION$$END$ } while ($expression$);

          Parameters

          • expression - Suggests variables of the specified type.

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          checked

          checked block

          Scope C# 2.0+ statements

          Body

          checked { $END$ }

          Parameters

          • END - The caret position after the template is applied.

          if

          if statement

          Scope C# 2.0+ statements

          Body

          if ($expr$) { $SELECTION$$END$ }

          Parameters

          • expr - Show basic code completion list at the point where the variable is evaluated

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          lock

          lock statement

          Scope C# 2.0+ statements

          Body

          lock ($expression$) { $SELECTION$$END$ }

          Parameters

          • expression - Suggests variables of the specified type.

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          mbox

          MessageBox.Show

          Scope C# 2.0+ statements

          Body

          System.Windows.Forms.MessageBox.Show("$string$");

          Parameters

          • string - Evaluates to the specified constant value.

          using

          using statement

          Scope C# 2.0+ statements

          Body

          using($resource$) { $SELECTION$$END$ }

          Parameters

          • resource - Show basic code completion list at the point where the variable is evaluated

          • SELECTION - The text selected by the user before invoking the template.

          • END - The caret position after the template is applied.

          hal

          ASP.NET MVC Html.ActionLink

          Scope C# 2.0+ expressions

          Body

          Html.ActionLink("$TEXT$", "$ACTION$", "$CONTROLLER$")

          Parameters

          • CONTROLLER - Show completion list with available ASP.NET MVC Controllers at the point where the variable is evaluated

          • ACTION - Show completion list with available ASP.NET MVC Actions at the point where the variable is evaluated

          • TEXT - no macro

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          ua

          ASP.NET MVC Url.Action

          Scope C# 2.0+ expressions

          Body

          Url.Action("$ACTION$", "$CONTROLLER$")

          Parameters

          • CONTROLLER - Show completion list with available ASP.NET MVC Controllers at the point where the variable is evaluated

          • ACTION - Show completion list with available ASP.NET MVC Actions at the point where the variable is evaluated

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          rta

          ASP.NET Controller RedirectToAction

          Scope C# 2.0+ expressions

          Body

          RedirectToAction("$ACTION$", "$CONTROLLER$")

          Parameters

          • CONTROLLER - Show completion list with available ASP.NET MVC Controllers at the point where the variable is evaluated

          • ACTION - Show completion list with available ASP.NET MVC Actions at the point where the variable is evaluated

          Before expansion

          JetBrains Rider: Live templates
          After expansion
          JetBrains Rider: Live templates

          attachedProperty

          Attached property

          Scope C# 2.0+ type members

          Body

          public static readonly $dependencyProperty$ $propertyName$Property = $dependencyProperty$.RegisterAttached( "$propertyName$", typeof($propertyType$), typeof($containingType$), new PropertyMetadata(default($propertyType$))); public static void Set$propertyName$(DependencyObject $element$, $propertyType$ value) { $element$.SetValue($propertyName$Property, value); } public static $propertyType$ Get$propertyName$(DependencyObject $element$) { return ($propertyType$) $element$.GetValue($propertyName$Property); }

          Parameters

          • propertyType - no macro

          • propertyName - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          • containingType - Evaluates to short name of the most inner containing type.

          • element - no macro

          • dependencyProperty - Evaluates to dependency property type specific to current framework

          The template creates an attached property with required get and set procedures.

          dependencyProperty

          Dependency property

          Scope C# 2.0+ type members

          Body

          public static readonly $dependencyProperty$ $propertyName$Property = $dependencyProperty$.Register( "$propertyName$", typeof($propertyType$), typeof($containingType$), new PropertyMetadata(default($propertyType$))); public $propertyType$ $propertyName$ { get { return ($propertyType$) GetValue($propertyName$Property); } set { SetValue($propertyName$Property, value); } }

          Parameters

          • propertyType - no macro

          • propertyName - When executed in variable declaration (where variable name should stand), suggests name for the variable.

          • containingType - Evaluates to short name of the most inner containing type.

          • dependencyProperty - Evaluates to dependency property type specific to current framework

          test

          Scope C# 2.0+ type members, references nunit.framework|nunit

          Body

          [Test] public void $METHOD$() {$END$}

          Parameters

          • METHOD - no macro

          • END - The caret position after the template is applied.

          Last modified: 07 April 2022