In this article learn how to create and use Jetbrains ReSharper’s Source templates and to explore Postfix templates.
Note All source templates presented are in the GitHub repository
With these templates a developer can write less code in many cases.
Simple example, we want to write the following code which without Postfix templates everything needs to be hand typed.
using (var cn = new SqlConnection())
{
}
Working with SqlClient
new SqlConnection()
Next type using
and press Enter
After pressing Enter there is a prompt to use var
or the type, use Up and Down arrows to select.
Press TAB and name choices appear, use Up and Down arrows to select or type in your own name.
Create a foreach
The task is to iterate data read from a file using a foreach which should look like the following.
List<Customers> customersList =
JsonSerializer.Deserialize<List<Customers>>(
File.ReadAllText("Customers.json"));
foreach (var customer in customersList!)
{
Console.WriteLine($"{customer.Id,-3}{customer.Company}");
}
🔹 Step 1, create the model.
public class Customers
{
public int Id { get; set; }
public string Company { get; set; }
public string Title { get; set; }
public string Contact { get; set; }
public string Country { get; set; }
public string Phone { get; set; }
public DateTime Modified { get; set; }
}
🔹 Step 2, read the file
List<Customers> customersList =
JsonSerializer.Deserialize<List<Customers>>(
File.ReadAllText("Customers.json"));
Type the variable name, . then foreach (no upper casing) and press Enter
to get a prompt same as last example for var or type then variable name.
See the following documentaton for a list of postfix templates.
Also, under Resharper options they are listed and can be turned off.
These templates are really cool to create your own postfix templates were the template is for a specific project or solution as per documentation. Templates can be created in the same project they will be used in or create a Visual Studio solution for source templates only and reference the class project into your projects.
The task is to get parts for a DateOnly.
Our source
static DateOnly BirthDate()
=> new(2022, 9, 2);
Extract Month, Day and Year
var dateOnly = BirthDate();
var month = dateOnly.Day;
var year = dateOnly.Year;
var day = dateOnly.Day;
Or we can Deconstruct were after typing var dateOnly = BirthDate();
Which is possible using the following method incuded in SourceTemplateLibrary class project along with other similar methods.
After accepting
var (day, month, year) = BirthDate();
Code For BirthDate()
static DateOnly BirthDate()
=> new(2022, 9, 2);
To create the above with a source template.
- Create a static class
- Add the following NuGet package JetBrains.Annotations
- Create the following extension method
[SourceTemplate]
public static void ds(this DateTime sender)
{
var (day, month, year) = sender;
}
- Builds the project
- Type BirthDate() for this example follows bs
ds
, press Enter
And Resharper provides
var (day, month, year) = BirthDate();
Let's say you don't need one of the parts, use a discard.
var (day, _, year) = BirthDate();
The same can be done for a TimeOnly, create the following extension method.
public static class TimeOnlyExtensions
{
public static void Deconstruct(this TimeOnly time, out int hour, out int minutes, out int seconds, out int milliseconds)
=> (hour, minutes, seconds, milliseconds) =
(time.Hour, time.Minute, time.Second, time.Microsecond);
}
Create the source template in a static class
[SourceTemplate]
public static void ds(this TimeOnly sender)
{
var (hour, minutes, seconds, milliseconds) = sender;
}
Note Two things, Reshaper uses lower casing for source templates which is done here, secondly, the names were kept simple ds for Deconstruct. Feel free to use different names that make sense to you.
Suppose there is a need to see if a DateTime is a weekday or weekend.
Create the following class for logic to see if a date is a weekday or weekend.
public static class DateTimeExtensions
{
public static bool IsWeekend(this DateTime self)
=> self.DayOfWeek is DayOfWeek.Sunday or DayOfWeek.Saturday;
public static bool IsWeekDay(this DateTime self)
=> !self.IsWeekend();
public static bool IsWeekDay(this DayOfWeek sender)
{
return sender is DayOfWeek.Monday or
DayOfWeek.Tuesday or
DayOfWeek.Wednesday or
DayOfWeek.Thursday or
DayOfWeek.Friday;
}
public static bool IsWeekend(this DayOfWeek sender) => !sender.IsWeekDay();
}
Create the source template in a static class. Note //$
[SourceTemplate]
public static void weekday(this DateTime sender)
{
if (sender.IsWeekDay())
{
//$ $END$
}
}
Now to iterate a list of DateTime the final results for this code sample will be...
var dates = DateTimesList();
foreach (var date in dates)
{
if (date.IsWeekDay())
{
Console.WriteLine(date.DayOfWeek);
}
}
With the following source
private static List<DateTime> DateTimesList()
=> Enumerable.Range(1, 7)
.Select(day => new DateTime(2023, 7, day))
.ToList();
Once the following has been entered
var dates = DateTimesList();
Type dates dates.foreach
and press Enter to use the built in postfix template. We get the following.
foreach (var dateTime in dates)
{
}
Place the cursor in the body of the foreach
and type the following to use the custom source template.
dateTime.weekday
Press Enter or TAB and the following is written.
foreach (var dateTime in dates)
{
if (dateTime.IsWeekDay())
{
}
}
In this example the task is to iterate a SqlDataReader from a SqlCommand.
🔸 Desired finished code
var statement = "SELECT CountryId, [Name] FROM dbo.Countries;";
var connectionString = _configuration.GetValue<string>("ConnectionStrings:ApplicationConnection");
using SqlConnection cn = new(connectionString);
using SqlCommand cmd = new(statement, cn);
try
{
cn.Open();
SqlDataReader? reader = cmd.ExecuteReader();
while (reader.Read())
{
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
Even if the developer types fast with source templates the above code can be in about 20 seconds or less.
This example is done in a Console project so there are several NuGet packages needed. Open the project file and note packages starting with Microsoft.Extensions
.
The connection string is in appsettings.json
{
"Logging": {
"LogLevel": {
"Default": "Information",
"Microsoft.AspNetCore": "Warning"
}
},
"AllowedHosts": "*",
"ConnectionStrings": {
"ApplicationConnection": "Data Source=.\\SQLEXPRESS;Initial Catalog=EF.UsingInterfaces;Integrated Security=True;Encrypt=False"
}
}
Add the following variable for getting the connection string
private static IConfiguration? _configuration;
Now lets use one standard postfix template and two custom source templates.
Data to read
Create the following method
static void SqlClientExample()
{
var statement = "SELECT CountryId, [Name] FROM dbo.Countries;";
}
Under var statment
type the following and press Enter
new SqlConnection().create
Which writes out the following
static void SqlClientExample()
{
var statement = "SELECT CountryId, [Name] FROM dbo.Countries;";
var connectionString = _configuration.GetValue<string>("ConnectionStrings:ApplicationConnection");
using SqlConnection cn = new(connectionString);
using SqlCommand cmd = new("statement", cn);
try
{
cn.Open();
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
}
Remove the quotes on statement
using SqlCommand cmd = new(statement, cn);
Under cn.Open()
type the following and press Enter
cmd.reader
Which writes out a variale for a SqlDataReader and a while statement as follows.
static void SqlClientExample()
{
var statement = "SELECT CountryId, [Name] FROM dbo.Countries;";
var connectionString = _configuration.GetValue<string>("ConnectionStrings:ApplicationConnection");
using SqlConnection cn = new(connectionString);
using SqlCommand cmd = new(statement, cn);
try
{
cn.Open();
SqlDataReader? reader = cmd.ExecuteReader();
while (reader.Read())
{
}
}
catch (Exception exception)
{
Console.WriteLine(exception.Message);
}
}
Add a line to read out data to the console and run the code.
while (reader.Read())
{
Console.WriteLine($"{reader.GetInt32(0),-3}{reader.GetString(1)}");
}
To get a connection string for EF Core in Program.cs this is one method.
builder.Services.AddDbContext<Context>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("ApplicationConnection"))
.EnableSensitiveDataLogging());
The following is only here to show how to create a source template for a DbContext.
Create the following class where source templates reside.
internal class Context : DbContext
{
}
Note In this case your DbContext is named Context, change it for the DbContext used in your project.
Now the following source templates can be used.
public static class AspNetCoreTemplates
{
[SourceTemplate]
public static void connectstring(this WebApplicationBuilder builder)
{
var connectionString = builder.Configuration.GetConnectionString("ApplicationConnection");
}
[SourceTemplate]
public static void connectionpool(this WebApplicationBuilder builder)
{
builder.Services.AddDbContextPool<Context>(options =>
options.UseSqlServer(
builder.Configuration.GetConnectionString("ApplicationConnection")));
}
[SourceTemplate]
public static void connection(this WebApplicationBuilder builder)
{
builder.Services.AddDbContext<Context>(options =>
options.UseSqlServer(
builder.Configuration
.GetConnectionString("ApplicationConnection")));
}
}
In Program.cs type builder.connection and press Enter to write the following.
public class Program
{
public static void Main(string[] args)
{
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<Context>(options =>
options.UseSqlServer(
builder.Configuration
.GetConnectionString("ApplicationConnection")));
Using NuGet package Microsoft.Data.SqlClient version 5.1.1 (at the time of this article) its possible to return DateOnly and TimeOnly using SqlClient data provider.
First create several extension methods
public static class SqlClientExtensions
{
public static DateOnly GetDateOnly(this SqlDataReader reader, int index)
=> reader.GetFieldValue<DateOnly>(index);
public static TimeOnly GetTimeOnly(this SqlDataReader reader, int index)
=> reader.GetFieldValue<TimeOnly>(index);
}
In a static class add the following source template
[SourceTemplate]
[Macro(Target = "dto")]
public static void gdo(this SqlDataReader reader, int index)
{
var dto = reader.GetDateOnly(index);
}
Where there is a SqlDataReader type and press Enter
reader.gdo
The following is written, first prompting for a ordinal position in plac of index
var dto = reader.GetDateOnly(index);
Enter the index, press TAB to optionally change the current variable name from dto to something useful.
Add the following method to a static class
[SourceTemplate]
[Macro(Target = "T")]
[Macro(Target = "varName")]
public static void checker<T>(this string sender, T type) where T : struct
{
if (Enum.TryParse(sender, true, out T varName))
{
}
}
When invoked
- There is a prompt for T to enter an enum
- Press TAB for a prompt for a out variable name
Usage
public enum DemoEnum
{
One,
Two,
Three
}
In your code add
var value = "one";
Type value.checker and the following is written
- Enter the type
- TAB
- Enter the variable name
var value = "one";
if (Enum.TryParse(value, true, out DemoEnum result))
{
}
With what has been presented a developer can use the source templates provided along with created their own templates along with knowledge that Postfix templates built into ReSharper can reduce coding time.
Clone the following GitHub repository and run the script under ConsoleApp1 project in the Scripts folder.
https://dev.to/karenpayneoregon/learn-resharper-postfix-and-source-templates-32lo