Windows.Foundation 命名空间

启用基本的 Windows 运行时功能,包括管理异步操作和访问属性存储。 此命名空间还定义了表示统一资源标识符(URI)、日期和时间、二维度量和其他基本值的常见值类型。

类

名称 说明
Deferral

存储延迟完成后要调用的 DeferralCompletedHandler ,并处理延迟的状态。

GuidHelper

包含用于处理 Guid 类型的静态帮助程序方法的类。

MemoryBuffer

表示引用计数内存缓冲区。

PropertyValue

表示属性存储区中的值(如 PropertySet 实例)。

Uri

定义一个对象,该对象表示统一资源标识符(URI)值并将其分析为组件。 Uri 对象由许多其他 Windows 运行时 API 使用,这些 API 不一定局限于 Web 浏览器方案。

.NET使用 .NET 编程时,此类型是隐藏的,开发人员应使用 System.Uri。 请参阅“备注”。

WwwFormUrlDecoder

分析 URL 查询字符串,并将结果公开为查询字符串中名称值对的只读向量(列表)。

WwwFormUrlDecoderEntry

表示 URL 查询字符串中的名称/值对。 请改用 IWwwFormUrlDecoderEntry 接口;请参阅“备注”。

结构

名称 说明
DateTime

表示一个即时时间,通常表示为日期和时间。

JavaScript 此类型显示为 Date 对象。

.NET使用 .NET 编程时,此类型是隐藏的,开发人员应使用 System.DateTimeOffset 结构。

C++/CX 类似于 FILETIME ,但存在重要差异。 请参阅“备注”。

C++/WinRT 此类型是 std::chrono::time_point 的专用化。 请参阅“备注”。

EventRegistrationToken

表示对接收更改通知的委托的引用。

.NET使用.NET编程时,此类型处于隐藏状态。 对于高级方案,请改用 System.Runtime.InteropServices.WindowsRuntime.EventRegistrationToken 。

C++/WinRT 在 C++/WinRT 语言投影中,此类型显示为 winrt::event_token。

HResult

表示 Windows 运行时错误。

.NET使用 .NET 编程时,此类型将被隐藏,异常显示为 System.Exception 或特定的派生异常类型。 请参阅“备注”。

Point

表示定义二维平面中的点的 x 坐标值和 y 坐标值。

Rect

包含表示矩形位置和大小的数字值。

Size

表示指定高度和宽度的数字值。

TimeSpan

将时间间隔表示为有符号 64 位整数值。

.NET使用 .NET 编程时,此结构是隐藏的,开发人员应使用 System.TimeSpan 类型。

C++/WinRT 此类型是 std::chrono::d uration 的专用化。

TimeSpan 用于 自适应流式处理示例应用。

接口

名称 说明
IAsyncAction

表示异步操作。 这是许多没有结果对象的 Windows 运行时 (WinRT) 异步方法的返回类型,不会报告正在进行的进度。

IAsyncActionWithProgress<TProgress>

表示可以向调用方报告进度更新的异步操作。 这是所有没有结果对象的 Windows 运行时异步方法的返回类型,但向回调侦听器报告进度。

IAsyncInfo

支持异步操作和操作。 IAsyncInfo 是 IAsyncAction、IAsyncActionWithProgress TProgress<>、IAsyncOperation<TResult> 和 IAsyncOperationWithProgress TResult、TProgress<> 的基本接口,每个接口都支持异步方法的返回类型和进度的组合。

IAsyncOperation<TResult>

表示一个异步操作,该操作在完成时返回结果。 这是许多具有结果但未报告进度的 Windows 运行时 (WinRT) 异步方法的返回类型。

IAsyncOperationWithProgress<TResult,TProgress>

表示可以向调用方报告进度更新的异步操作。 这是许多具有结果和报告进度的 Windows 运行时异步方法的返回类型。

IClosable

定义释放已分配资源的方法。

.NET此接口显示为 System.IDisposable。

C++/CX 此接口显示为 Platform::IDisposable。

IGetActivationFactory

定义检索激活工厂的类型实现。

IMemoryBuffer

表示引用计数内存缓冲区。

IMemoryBufferReference

表示对 IMemoryBuffer 对象的引用。

IPropertyValue

表示属性存储区中的值。 无法实现此接口,请参阅“备注”。

IReference<T>

允许将任意枚举、结构和委托类型用作属性值。

.NET此接口显示为可以为<Null 的 T>。

C++/CX 此接口显示为 Platform::IBox<T>

IReferenceArray<T>

允许任意枚举、结构和委托类型用作属性值数组。 无法实现此接口,请参阅“备注”。

IStringable

提供将当前对象表示为字符串的方法。

IWwwFormUrlDecoderEntry

表示 URL 查询字符串中的名称/值对。

枚举

名称 说明
AsyncStatus

指定异步操作的状态。

PropertyType

指定属性值类型。

委托

名称 说明
AsyncActionCompletedHandler

表示处理异步操作的已完成事件的方法。

AsyncActionProgressHandler<TProgress>

表示处理提供进度更新的异步操作的进度更新事件的方法。

AsyncActionWithProgressCompletedHandler<TProgress>

表示处理异步操作的已完成事件的方法,该事件提供进度更新。

AsyncOperationCompletedHandler<TResult>

表示处理异步操作的已完成事件的方法。

AsyncOperationProgressHandler<TResult,TProgress>

表示处理提供进度更新的异步操作的进度更新事件的方法。

AsyncOperationWithProgressCompletedHandler<TResult,TProgress>

表示处理异步操作的已完成事件的方法,该事件提供进度更新。

DeferralCompletedHandler

表示处理延迟操作的已完成事件的方法。

EventHandler<T>

表示处理常规事件的方法。

.NET此类型显示为 System.EventHandler<TEventArgs>。

TypedEventHandler<TSender,TResult>

表示处理常规事件的方法。

注解

Windows。Foundation 是Windows 运行时类型系统的核心命名空间。 它提供基本类型,例如异步操作接口、URI、DateTime 和属性值转换器,所有其他 WinRT 命名空间都基于这些转换器。

注释

应用框架兼容性:Windows。基础类型可用于支持 WinRT 的所有应用框架,包括Windows 应用 SDK(WinUI 3)、Win32 桌面应用(通过 C#/WinRT 或 C++/WinRT)和 UWP 应用。 不需要 UWP 项目才能使用这些类型。

另请参阅