La siguiente nota fue tomada de la pagina de http://www.aaron-powell.com y fue traducida al español

Razor es soportado desde la version 4.6, es recomendable usarlo desde la version 4.7 ya que esta soportado de manera mas robusta. Es una alternativa para crear macros como XSLT. Algunas ventajas son:

• Compacto, expresivo y fluido.
• Facil de aprender
• No es un lenguaje nuevo
• Trabaja con cualquier editor
• Si usa VS  funciona bn con intellisense

Trabajando Razor en Umbraco

Que se necesita para trabar Razor en Umbraco?

Bueno crear un macro Razor es muy parecido a crear un macro normal a traves de la interfaz de Umbraco.

Los archivos de Razor se encuentran en la carpeta /python si quiere cambiar su localización puede ajustar en las configuraciones la siguiente llave:

 <add key="umbracoPythonPath" value="/Razor" />

Si queremos crear un macro Razor a traves de umbraco debemos dirigirnos a la seccion Developer y en la carpeta de scripts hacemos clic derecho crear:

Esto nos mostrara el siguiente cuadro:

 Ahora podemos crear el macro que necesitemos usando Razor.

Para insertar el macro lo hacemos como si fuera un user control o un xslt, desde la plantilla o desde el contenido, como sea de nuestra preferencia.

Mi primer macro en Razor

Con los macros en Razor existen algunas diferencias, por ejemplo con XSLT usamos $currentPAge, ahora tenemos una propiedad Model con la cual trabajaremos.

La propiedad Model es un objeto dinamico, el cual permite acceder a las propiedades como se muestra a continuación:

<h2>@Model.siteName</h2>

<p>@Model.siteDescription</p>

Esta es una forma mas fácil de acceder a las propiedades del modelo, con esto nos evitamos el uso de getProperty("siteName").value

Con esto tenemos lo mas básico en Razor que nos accede a las propiedades y nos muestra el titulo y la descripción del sitio.

Aca puede ver mas ejemplos de Razor (UmbraColombia)

Descargar ejemplos Cultiv Razor (solo Razor)

Descargar ejemplos Cultiv Razor (Completo)

Referencias:

http://www.aaron-powell.com/umbraco-4-and-razor

http://our.umbraco.org/wiki/reference/code-snippets/razor-snippets