---
title: Web 平台 .NET API 支持
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/platform-specific/webgl/develop/web-dotnet-api-support
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/platform-specific/webgl/develop/web-dotnet-api-support.md
last_updated: 2026-10-03
generated_at: 2026-11-16T11:02:50.075Z
locale: zh-cn
---

# Web 平台 .NET API 支持

> 了解 .NET API ON Web 平台上的局限性，包括不受支持的Namespaces空间和替代方法。

Web 平台支持大多数 [.NET API](https://learn.microsoft.com/en-us/dotnet/api/?view=netframework-4.8.1)，但由于浏览器 SECURITY 限制、缺少 Managed 线程以及缺少原始网络套接字访问，某些 API 存在局限性。

## System.Collections.Concurrent##system.collections.concurrent

`System.Collections.Concurrent`中的所有容器都在 Web 平台上编译，但它们缺乏真正的线程安全性。Unity 将这些容器中的同步图元替换为空函数。使用 [Collections 包](https://docs.unity3d.com/Packages/com.unity.collections@6.6/manual/index.html)替代爆发编译的作业。

## System##system.io

大多数文件 I/O 通过 Emscripten 的内存虚拟文件系统 (MEMFS) 工作。异步 I/O API 不起作用，因为它们受`ThreadPool`支持。表列出了具有限制的 API。

| **类**                       | **状态** | **注意**                                             |
| --------------------------- | ------ | -------------------------------------------------- |
| **DriveInfo**               | 不支持。   | All methods 抛出 `NotSupportedException`。            |
| **FileStream**              | 部分支持   | All Synchronous 操作都可以运行。异步方法会导致无法恢复的浏览器挂起。         |
| **FileSystemAclExtensions** | 不支持。   | 仅限 Windows。All methods 抛出 `NotSupportedException`。 |

## System##system.threading

由于 Web 平台Support持托Managed线程，因此此命名空间空间中的大多数 API 的功能有限。同步图元在不抛出的情况下编译和执行，但其线程行为没有特效。唯一的例外是 `Interlocked`、`Thread.MemoryBarrier` 和 `Volatile`，它们在爆发编译的作业中提供真实的硬件语义。

表列出了具有限制的 API。

| **类**                           | **状态** | **注意**                                                                               |
| ------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| **CancellationTokenSource**     | 部分支持   | 超时机制不起作用，因为它依赖于 ON `Timer`。                                                          |
| **CompressedStack**             | 不支持。   | All methods 抛出 `NotSupportedException`。                                              |
| **EventWaitHandle**             | 不支持。   | 命名事件句柄抛出`NotSupportedException`。Other 方法执行但没有特效。                                     |
| **HostExecutionContextManager** | 不支持。   | All methods 抛出 `NotImplementedException`。                                            |
| **互锁**                          | 部分支持   | 该方法在 Managed 代码中执行时没有特效，但在爆发编译的作业中提供真实的硬件语义。                                         |
| **Monitor**                     | 不支持。   | Other 方法执行但没有特效。                                                                     |
| **Mutex**                       | 不支持。   | 指定的互斥体抛出`NotSupportedException`。Other 方法执行但没有特效。                                     |
| **信号**                          | 不支持。   | 命名信号量抛出`NotSupportedException`。Other 方法执行但没有特效。                                      |
| **线程**                          | 不支持。   | 可以构造。`Start()`不会抛出，但线程委托不会执行。`Join`、`Priority`（设置）和`DisableComObjectEagerCleanup`失败。 |
| **Thread.MemoryBarrier**        | 部分支持   | 该方法在 Managed 代码中执行时没有特效，但在爆发编译的作业中提供真实的硬件语义。                                         |
| **ThreadPool**                  | 不支持。   | `QueueUserWorkItem` 和 `UnsafeQueueUserWorkItem` 接受 Calls 但回调从不执行。                    |
| **Timer**                       | 不支持。   | 不起作用，因为它依赖于 ON `ThreadPool`。                                                         |
| **波动**                          | 部分支持   | 该方法在 Managed 代码中执行时没有特效，但在爆发编译的作业中提供真实的硬件语义。                                         |

## System##system.threading.tasks

`System.Threading.Tasks` 命名空间中的以下类型和方法可以正常运行：

* `ValueTask`
* `ValueTask<T>`
* `TaskCompletionSource<T>`
* Synchronous 工厂方法，例如 `Task.FromResult` 和 `Task.CompletedTask`。

通过`ThreadPool`调度工作的所有 API 都会导致无法恢复的浏览器挂起。使用 [`Awaitable`](/engine/6000.0/manual/scripting/optimization/async-await-support/async-awaitable-introduction.md) 进行异步编程，因为它比 `Task` 具有更低的内存开销。

表列出了具有限制的 API。

| **类**                           | **状态** | **注意**                                                               |
| ------------------------------- | ------ | -------------------------------------------------------------------- |
| **并行**                          | 不支持。   | All 方法（`For`、`ForEach`、`Invoke`）都会导致无法恢复的浏览器挂起。                      |
| **Task.延时**                     | 不支持。   | 导致无法恢复的浏览器挂起。内部部计Timer不Fire。                                         |
| **Task.运行**                     | 不支持。   | 导致无法恢复的浏览器挂起。计划通过 `ThreadPool` 运行。                                   |
| **TaskFactory/TaskFactory\<T>** | 不支持。   | `StartNew`、`ContinueWhenAll` 和 `ContinueWhenAny` All 都会导致无法恢复的浏览器挂起。 |

## System.Timers##system.timers

`System.Timers.Timer` ON Web 平台无效，因为 `Elapsed` 事件依赖于线程池机制，而该机制不起作用。

## System 和 System##system.net-and-system.net.http

`System.Net` 和 `System.Net.Http` Namespaces 中的以下数据类可以正常运行：

* `Cookie`
* `WebHeaderCollection`
* `SocketAddress`
* `HttpRequestMessage`
* `StringContent`
* `MultipartContent`

不支持 `HttpListener`，因为无法在浏览器中运行 Web Server。

以下类未实现并导致无法恢复的浏览器挂起：

* `HttpClient`
* `WebClient`
* `HttpWebRequest`
* `FileWebRequest`

使用 [UnityWebRequest](https://docs.unity3d.com/ScriptReference/Networking.UnityWebRequest.html) 替代 HTTP 请求。

## System.Net.Security##system.net.security

不支持 `SslStream` 和 `NegotiateStream`。配置选项有效。

## System##system.net.sockets

浏览器沙盒不会显示 POSIX 套接字。只有纯数据类型（如 `LingerOption` 和 `SocketException`）有效。

或者，通过 Javascript 插件使用浏览器的 [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) 或 [WebRTC](https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API) API。另一个选项是 [Emscripten POSIX 套接字实现](https://emscripten.org/docs/porting/networking.html)，它通过基于 WebSocket 的 Relay Server 代理套接字操作，从而连接到非 Web 客户端或服务器上的实际套接字端口。

## System.Net.WebSockets##system.net.websockets

不支持 `ClientWebSocket`。直接通过 Javascript 插件或第三方插件使用浏览器的 [WebSocket API](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket)。

## 其他资源##additional-resources

* [Web 多线程简介](/engine/6000.0/manual/web-multithreading-intro.md)
* [UnityWebRequest](https://docs.unity3d.com/ScriptReference/Networking.UnityWebRequest.html)
* [Awaitable 异步编程简介](/engine/6000.0/manual/scripting/optimization/async-await-support/async-awaitable-introduction.md)
* [实例化网络](https://emscripten.org/docs/porting/networking.html)
