[ApiController]
[Route("[controller]")]
public class ExampleWsController : ControllerBase
{
    private WebSocket socket;

    private void SendMessage(string message)
    {
        socket.SendAsync(new ArraySegment<byte>(Encoding.UTF8.GetBytes(message)), WebSocketMessageType.Text, true, CancellationToken.None);
    }

    private async Task HandleWebSocket()
    {
        try
        {
            while (socket.State == WebSocketState.Open)
            {
                var buffer = new byte[1024 * 4];
                var result = await socket.ReceiveAsync(new ArraySegment<byte>(buffer), CancellationToken.None); // 获得客户端消息
                while (!result.CloseStatus.HasValue)
                {
                    // 解析请求后按不同情况处理
                    var messageFromClient = Encoding.UTF8.GetString(buffer, 0, result.Count);
                    switch (messageFromClient)
                    {
                        case "message1":
                            break;
                        case "message2":
                            break;
                        case "message3":
                            break;
                    }
                }
            }
        }
        catch (Exception ex)
        {
            // Handle exceptions
        }
        finally
        {
            if (socket.State == WebSocketState.Open)
                await socket.CloseAsync(WebSocketCloseStatus.NormalClosure, "Connection closed by client", CancellationToken.None);
        }
    }

    [HttpGet("GetExampleWs")]
    public async Task GetExampleWs()
    {
        if (HttpContext.WebSockets.IsWebSocketRequest)
        {
            // 建立连接
            socket = await HttpContext.WebSockets.AcceptWebSocketAsync();
            await Task.Run(() => HandleWebSocket());
        }
        else
        {
            HttpContext.Response.StatusCode = 400;
        }
    }
}

GetExampleWs() 用于建立 ws 连接，请求 url 路径为 ws://localhost/ExampleWs/ExampleWs.

HandleWebSocket() 用于处理发送过来的请求，或者向对方发送消息。

XML 反序列化

当 XML 中有值需要反序列化为枚举时，需用 [XmlEnum()]来建立映射关系^[6]。

例如：

<EnumValue>1</EnumValue>

/// <summary>
/// 用于接收反序列化的对象
/// </summary>
[Serializable]
public class XmlExample {
    [XmlElement("EnumValue")]
    EnumExample EnumValue {get; set;}
}

[Serializable]
public enum EnumExample {
    [XmlEnum("1")]
    Example = 1,
}

需用 [XmlEnum("1")] 来建立 XML 中对应值与枚举中对应类型的映射关系。

PS: 序列化对象参考，反序列化对象参考

重写相等操作

相等操作要满足数学上相等的定义：
参考
- 自反性、
  x.equals(x) 等于 true
- 对称性、
  x.equals(y) 等于 y.equals(x)
- 传递性、
  x.equals(y) 返回 true，并且 y.equals(z) 也返回 true，那么 x.equals(z) 必须返回 true
- 一致性、
  如果多次将对象与另一个对象比较，结果始终相同。只要未修改 x 和 y 的应用对象，x.equals(y) 连续调用 x.equals(y) 返回相同的值
- 非 null
  如果 x 不是 null，y 为 null，则 x.equals(y) 必须为 false

重载等于操作时需要实现的接口

Equals(object?) 和 GetHashCode() 可以用 VS 默认实现^[7]，或参考下面的样例代码。

public class Example : IEquatable<Example>
{
    public int Member1;
    public double Member2;
    public static bool operator ==(Example left, Example right)
    {
        return left.Member1 == right.Member1 && left.Member2 == right.Member2;
    }
    
    public static bool operator !=(Example left, Example right)
    {
        return left.Member1 != right.Member1 || left.Member2 != right.Member2;
    }
    
    public override bool Equals([NotNullWhen(true)] object? obj)
    {
        return GetType() != obj?.GetType() || Equals(obj);
    }
    
    public bool Equals(Example? other)
    {
        return other is not null && (ReferenceEquals(this, other) || other == this);
    }
    
    public override int GetHashCode()
    {
        return HashCode.Combine(Member1, Member2);
    }
}

operator== 和 Equals 要在语义上相等。

由于重载了 operator==，Object.Equals(object?) 语义要与其一致，则需重载；而 Object.Equals(object?) 改变后会影响 Object.GetHashCode()，也需要重载。

MVVM Toolkit 工具包

MVVM Toolkit简介

建议使用平台：.Net 8，较早的平台可能会出现奇怪的 Bug。

观察属性

用法

[ObservableProperty]
private string? name;

等价于

public string? Name
{
    get => name;
    set => SetProperty(ref name, value);
}

注

带批注字段需要位于具有必要 INotifyPropertyChanged 基础结构的分部类中才能发挥作用。

将基于字段名称创建生成的属性的名称。字段命名采用 lowerCamel、_lowerCamel 或者 m_lowerCamel，都会转换为 UpperCamel。生成的属性将始终具有公共访问器，但在声明该字段时可以使用任何可见性（建议使用 private）。

中继命令属性

用法

[RelayCommand]
private void GreetUser()
{
    
}

等价于

private RelayCommand? greetUserCommand;

public IRelayCommand GreetUserCommand => greetUserCommand ??= new RelayCommand(GreetUser);

注

为了正常工作，带批注的方法需要位于分部类中。如果对类型进行嵌套，则必须也将声明语法树中的所有类型批注为分部。

将基于方法名称创建生成的命令的名称。生成器将使用方法名称并在末尾追加“Command”，并且去除“On”前缀（如果存在）。此外，对于异步方法，“Async”后缀也会在追加“Command”之前去除。

PostSharp

WPF 的 Binding 操作

INotifyPropertyChanged 绑定

数据类的成员变量的set属性自动实现 INotifyPropertyChanged（搜索关键词：Automatically implement INotifyPropertyChanged）

使用

只需要在类上添加[NotifyPropertyChanged] ^[8]。

ICommand 绑定

命令类的简化实现

使用 ^[9]。

region 处为命令的名称，ExecuteName 为执行命令的函数（ object 参数根据情况添加，可有可无）。

class A {
    
    #region Name

    [Command]
    public ICommand NameCommand { get; set; }

    public void ExecuteName(object? parameter)
    {
        // ...
    }

    #endregion
}

XAML 文件配置，需要传入参数时添加 CommandParameter

<Button Command={Bingding NameCommand} CommandParameter="" />