Howard Richards conficient

This document describes options and proposals for #4048.

Overall goals

Principles:

In Razor Components, enable customers to use as much of ASP.NET Core's existing authentication/authorization/identity feature set as possible. Minimize the invention of new stuff; maximize orthogonality.
Provide a programming model that can be consistent across Razor Components (server-side) and Blazor (client-side), so components that use authorization can still be portable across the two, even if app-level Startup.cs logic is completely different for the two runtime environments.

The Razor Components auth feature set will be mostly the same as for MVC/Pages. We'll get the same long-tail features such as integration with 3rd-party social logins, 2FA, etc. The Razor Components template will support the same four auth options during project creation, and the "Scaffold Identity" feature will be usable on existing Razor Components projects.

Why sequence numbers should relate to code line numbers, not execution order

Or in other words, why you should hard-code sequence numbers, and not generate them programmatically.

Unlike .jsx files, .razor/.cshtml files are always compiled. This is potentially a great advantage for .razor, because we can use the compile step to inject information that makes things better or faster at runtime.

A key example of this are sequence numbers. These indicate to the runtime which outputs came from which distinct and ordered lines of code. The runtime uses this information to generate efficient tree diffs in linear time, which is far faster than is normally possible for a general tree diff algorithm.

Example

Error handling in Server-Side Blazor

Developers building Blazor applications should be aware of how the framework deals with exceptions, and what steps to take in order to maximize reliability and to detect and diagnose errors.

To recap, server-side Blazor is a stateful framework. For as long as users are interacting with your application, they maintain a connection to the server known as a circuit. The circuit holds all the active component instances, plus many other aspects of state such as the components' most recent render output and the current set of event-handling delegates that could be triggered by client-side events. If a user opens your application in multiple browser tabs, then they have multiple independent circuits.

As a high-level principle, Blazor treats most unhandled exceptions as fatal to that circuit. If a circuit is terminated due to an unhandled exception, the user can only continue by reloading the page to create a new circuit and starting again, although other circuits (e.g., th

	var tweet = "Currently chilling out at W1B 2EL, then on to WC2E 8HA or maybe even L1 8JF! :-)";

	// Here's a simple regex that tries to recognise postcode-like strings.
	// See http://en.wikipedia.org/wiki/Postcodes_in_the_United_Kingdom#Validation
	// for the rules on how UK postcodes are formatted.
	var postcode_regex = /[A-Z]{1,2}[0-9][0-9A-Z]?\s?[0-9][A-Z]{2}/g;

	var postcodes = tweet.match(postcode_regex);

	console.log(postcodes);

	:: 1) Download srvany.exe from Microsoft Windows 2003 Resource Kit (available free from Microsoft).
	:: 2) Copy srvany.exe into the folder where google drive is installed or next to this script file.
	:: 3) Run this script as an Administrator

	echo off
	cls

	SET STARTING_DIR=%CD%
	SET SCRIPT_DIR=%~dp0

	*******************************************************************************************************
	PLEASE NOTE THAT THIS IS NOW SOMEWHAT OUT OF DATE, THE GENERAL APT-GET LINUX INSTALL INSTRUCTIONS
	FOR UBUNTU/DEBIAN NOW LARGLEY WORK ON RASBIAN
	*******************************************************************************************************

	First things first, make sure your Raspberry PI has the latest updates for Raspbian on by running

	sudo apt-get -y update
	sudo apt-get -y upgrade

	using NuGet.Common;
	using NuGet.Configuration;
	using NuGet.Credentials;
	using NuGet.PackageManagement;
	using NuGet.Packaging;
	using NuGet.Packaging.Core;
	using NuGet.Packaging.Signing;
	using NuGet.ProjectManagement;
	using NuGet.Protocol;
	using NuGet.Protocol.Core.Types;

	using Microsoft.AspNetCore.Blazor;

	public interface ITab
	{
	RenderFragment ChildContent { get; }
	}