Поделиться через


DataRequest Класс

Определение

Позволяет приложению предоставлять содержимое, которым пользователь хочет поделиться, или указать сообщение, если возникает ошибка.

public ref class DataRequest sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataRequest final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataRequest
Public NotInheritable Class DataRequest
Наследование
Object Platform::Object IInspectable DataRequest
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем коде показано, как использовать объект DataRequest в рамках настройки данных в DataPackage для совместного использования с другим приложением.

//To see this code in action, add a call to ShareSourceLoad to your constructor or other
//initializing function.
private void ShareSourceLoad()
{
    DataTransferManager dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += new TypedEventHandler<DataTransferManager, DataRequestedEventArgs>(this.DataRequested);
}

private void DataRequested(DataTransferManager sender, DataRequestedEventArgs e)
{
    DataRequest request = e.Request;
    request.Data.Properties.Title = "Share Text Example";
    request.Data.Properties.Description = "An example of how to share text.";
    request.Data.SetText("Hello World!");
}

Комментарии

Приложение получает объект DataRequest при возникновении события datarequested . С помощью этого объекта ваше приложение может предоставлять данные целевому приложению с помощью объекта DataPackage , использовать объект deferral для вызова функции или информировать целевое приложение о возникновении ошибки.

Свойства

Data

Задает или получает объект DataPackage , содержащий содержимое, которым пользователь хочет поделиться.

Deadline

Возвращает крайний срок завершения отложенной операции отрисовки. Если выполнение выходит за пределы этого крайнего срока, результаты отложенной отрисовки игнорируются.

Методы

FailWithDisplayText(String)

Отменяет операцию совместного использования и предоставляет пользователю строку ошибки для отображения.

GetDeferral()

Поддерживает асинхронные операции совместного использования путем создания и возврата объекта DataRequestDeferral .

Применяется к