Avalonia中调用Web API需使用HttpClient(推荐单例或IHttpClientFactory注入),在ViewModel中异步发起GET/POST请求,检查响应状态并安全更新INotifyPropertyChanged属性以触发UI刷新,避免阻塞主线程。
在 Avalonia 中调用 Web API(如 RESTful 接口)和标准 .NET 应用一样,主要依靠 HttpClient,没有框架层面的特殊封装。关键在于正确管理生命周期、避免 UI 线程阻塞、处理异步结果并安全更新界面。
Avalonia 是跨平台 UI 框架,不内置 HTTP 客户端,所以直接使用 .NET 的 HttpClient(推荐注入为单例或使用 IHttpClientFactory)。例如在 ViewModel 中发起请求:
IApiService),内部封装 HttpClient 调用逻辑
例:var response = await _httpClient.GetAsync("https://api.example.com/users");
var content = new StringContent(JsonSerializer.Serialize(user), Encoding.UTF8, "application/json"); var response = await _httpClient.PostAsync("https://api.example.com/users", content);
response.IsSuccessStatusCode,再读取 await response.Content.ReadAsStringAsync()
Avalonia 的绑定系统支持异步属性,但 UI 更新必须在主线程执行。推荐方式是:用 await 获取数据后,在 ViewModel 中更新 INotifyPropertyChanged 属性(如 public ObservableCollection),Avalonia 会自动刷新视图。
Task.Wait() 或 .Result —— 会导致 UI 冻结ICommand(如 ReactiveCommand 或 RelayCommand),支持 async/awaitIsLoading)配合 NotifyPropertyChanged 控制按钮禁用或显示 Spinner如果 Web API 需要 Token 或 Cookie 认证,可在 HttpClient 中统一设置:
_httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
_httpClient.DefaultRequestHeaders.Add("X-Api-Key", "your-key");
http://localhost:5000)网络请求失败很常见,需明确提示用户而非静默失败:
HttpRequestException(网络异常)、JsonException(解析失败)、HTTP 状态码(如 401/404/500)IsLoading = true 并禁用按钮,完成后恢复不复杂但容易忽略的是生命周期管理 —— 不要在每次请求都 new HttpClient,也不要在 View 中直接写网络代码。把 HTTP 逻辑收进 service,ViewModel 负责协调状态,View 只管展示,这样既可测试又易维护。