Windows.Foundation 命名空間

啟用基本的 Windows 執行時間功能,包括管理異步操作和存取屬性存放區。 此命名空間也會定義代表統一資源識別元(URI)、日期和時間、2D 度量和其他基本值的一般實值類型。

類別

名稱 Description
Deferral

儲存一個延遲 完成的處理 程序,並在延遲完成後啟動,並操控延遲狀態。

GuidHelper

一個包含靜態輔助方法的類別,用於處理 Guid 型態。

MemoryBuffer

表示參考計數記憶體緩衝區。

PropertyValue

表示屬性儲存中的一個值(例如 PropertySet 實例)。

Uri

定義物件,此物件表示統一資源識別元 (URI) 值,並將其剖析為元件。 其他許多不一定受限於網頁瀏覽器案例的 Windows 執行時間 API 都會使用 Uri 物件。

.NET 使用 .NET 程式設計時,此類型是隱藏的,開發者應使用 System.Uri。 請參閱。

WwwFormUrlDecoder

剖析 URL 查詢字串,並將結果公開為查詢字串中名稱/值組的只讀向量(清單)。

WwwFormUrlDecoderEntry

表示 URL 查詢字串中的名稱/值組。 改用 IWwwFormUrlDecoderEntry 介面;詳見備註。

結構

名稱 Description
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 用於 Adaptive 串流樣本應用程式。

介面

名稱 Description
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 此介面呈現為可<空 T>。

C++/CX 此介面顯示為 Platform::IBox<T>

IReferenceArray<T>

啟用任意列舉、結構和委派型別,以做為屬性值陣列。 您無法實作此介面,請參閱。

IStringable

提供將目前物件表示為字串的方法。

IWwwFormUrlDecoderEntry

表示 URL 查詢字串中的名稱/值組。

列舉

名稱 Description
AsyncStatus

指定異步操作的狀態。

PropertyType

指定屬性值類型。

委派

名稱 Description
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 執行階段 類型系統的核心命名空間。 它提供所有其他 WinRT 命名空間所建立的基本類型——如非同步操作介面、URI、DateTime 及屬性值轉換器。

備註

應用程式框架相容性:Windows。基礎型別適用於所有支援 WinRT 的應用程式框架,包括 Windows 應用程式 SDK(WinUI 3)、Win32 桌面應用程式(透過 C#/WinRT 或 C++/WinRT)以及 UWP 應用程式。 你不需要 UWP 專案也能使用這些類型。

另請參閱