Windows.Foundation Пространство имен

Включает основные функциональные возможности среды выполнения Windows, включая управление асинхронными операциями и доступом к хранилищам свойств. Это пространство имен также определяет распространенные типы значений, представляющие универсальный идентификатор ресурса (URI), даты и время, 2-D измерения и другие основные значения.

Классы

Имя. Описание
Deferral

Сохраняет объект DeferralCompletedHandler , который будет вызываться после завершения отсрочки и управляет состоянием отсрочки.

GuidHelper

Класс, содержащий статические вспомогательные методы для работы с типом GUID .

MemoryBuffer

Представляет буфер памяти с подсчетом ссылок.

PropertyValue

Представляет значение в хранилище свойств (например, экземпляр PropertySet ).

Uri

Определяет объект, представляющий значение универсального идентификатора ресурса (URI) и анализирует его в компоненты. Объект URI используется многими другими API среды выполнения Windows, которые не обязательно ограничиваются сценариями веб-браузера.

.NET При программировании с помощью .NET этот тип скрыт, и разработчики должны использовать System.Uri. См. примечания.

WwwFormUrlDecoder

Анализирует строку запроса URL-адреса и предоставляет результаты как вектор только для чтения (список) пар "имя-значение" из строки запроса.

WwwFormUrlDecoderEntry

Представляет пару "имя-значение" в строке запроса URL-адреса. Вместо этого используйте интерфейс IWwFormUrlDecoderEntry ; см. примечания.

Структуры

Имя. Описание
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 этот интерфейс отображается как nullable<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 App SDK (WinUI 3), классические приложения Win32 (с помощью C#/WinRT или C++/WinRT) и приложений UWP. Для использования этих типов не требуется проект UWP.

См. также