为什么分模板
码巢只有一门语言:C#。模板的差别不在语法,而在程序入口的形状和运行后得到什么。新建项目时选一个模板,学习路径可以一路走到底而不用换语言。
| 模板 | 适合做什么 | 运行后看到 |
|---|---|---|
| 控制台程序 | 语法、算法、控制台输入输出 | 输出面板的文字 |
| 界面应用 | 用代码搭出手机界面并响应用户操作 | 预览区里可点击的界面 |
| HTTP 接口 | 路由、参数、状态码、JSON | 接口控制台里的请求与响应 |
新建项目页里模板按这三类分组,每个模板都带可运行示例,改一改就能看到结果。控制台组有「你好,世界」「LINQ 查询」「递归与排序」「泛型与异常」「类与继承」;界面应用组有「计数器」「待办清单」「多页面与存储」「常用控件」「图片与视频」「自定义样式」;HTTP 接口组有「接口入门」「REST 风格」「JSON 与状态码」。
控制台程序
入门默认的模板。入口是熟悉的 Main:
using System;
class Program
{
static void Main()
{
Console.WriteLine("你好,码巢!");
}
}
每次点「运行」都会重新执行一遍,上次运行留下的静态字段不会影响这一次。
界面应用
用 C# 描述界面:入口是 Build(),用 Ui 里的工厂方法拼出界面树:
using Codenest;
using static Codenest.Ui;
class MyApp : App
{
int count = 0;
public override View Build()
{
return Column(
Text("当前计数:" + count, TextKind.Title),
Button("加一", () => count++)
);
}
}
要点:
- 字段就是状态:
count是普通字段。交互触发后Build()整体重跑,界面永远反映字段的当前值,不需要任何响应式包装。 - 控件来自
Ui:Column/Row/Card/Text/Title/Muted/Button/PrimaryButton/Field/Divider等,using static Codenest.Ui;之后可以直接调用。 - 回调里改字段:
Button("加一", () => count++),点一次跑一次Build()。 - 状态会保留:界面应用在同一个项目里连续点击,字段值会持续累加;点「运行」才整体重置。
- 改代码不影响预览:预览区里的操作基于最近一次点「运行」时的代码,所以你改到一半也能继续点。
- 输入框用
Field:Field(值, 新值 => 字段 = 新值)可以读用户输入,示例「待办清单」就是按钮加输入框的组合。 - 更多控件:开关用
Switch,进度用Progress,小标签用Badge;多页面导航用Nav.Push,本地存储用Store。详见界面应用进阶。
HTTP 接口
后端同样可以用 C# 练:入口是 Configure(),往里注册路由处理函数。
using System.Collections.Generic;
using Codenest;
class NotesApi : Api
{
readonly List<string> notes = new List<string>();
public override void Configure()
{
Get("/notes", req => Results.Json(notes));
Post("/notes", req =>
{
notes.Add(req.Body.Trim());
return Results.Json(new { total = notes.Count }, 201);
});
Delete("/notes/{index}", req =>
{
notes.RemoveAt(int.Parse(req.Route("index")));
return Results.Json(new { total = notes.Count });
});
}
}
要点:
- 没有真实端口:这是设备本地的进程内沙盒,请求由接口控制台发出、直接交给路由表,因此不需要联网,也不会暴露端口。
- 路由表可点:运行后接口控制台会列出所有路由,点一条即可自动填好方法与路径。
Request带路径参数与请求体:req.Route("index")取{index},req.Body是请求原文。Results构造响应:Results.Json(对象, 状态码)、Results.Text(...)、Results.Status(404, "说明")、Results.Empty(204)。- 实例状态保留:
Configure()只在点「运行」时执行一次,后一个请求能读到前一个请求写入的notes,可以完整走一遍增删查。