为什么分模板

码巢只有一门语言: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,可以完整走一遍增删查。

相关