DataTransferManager.DataRequested 事件

定義

命名空間:

Windows.ApplicationModel.DataTransfer

發生于共用作業啟動時。

// Register
event_token DataRequested(TypedEventHandler<DataTransferManager, DataRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void DataRequested(event_token const* cookie) const;

// Revoke with event_revoker
DataTransferManager::DataRequested_revoker DataRequested(auto_revoke_t, TypedEventHandler<DataTransferManager, DataRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<DataTransferManager,DataRequestedEventArgs> DataRequested;

function onDataRequested(eventArgs) { /* Your code */ }
dataTransferManager.addEventListener("datarequested", onDataRequested);
dataTransferManager.removeEventListener("datarequested", onDataRequested);
- or -
dataTransferManager.ondatarequested = onDataRequested;

Public Custom Event DataRequested As TypedEventHandler(Of DataTransferManager, DataRequestedEventArgs) 

事件類型

TypedEventHandler<DataTransferManager,DataRequestedEventArgs>

範例

此範例會使用內嵌函式來處理 datarequested 事件。

//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!");
}

備註

當您的應用程式以程式設計方式啟動共用作業時，就會引發此事件。 若要處理此事件，您必須將事件接聽程式新增至使用中視窗的 DataTransferManager 物件。 您可以透過 GetForCurrentView 方法取得這個物件。

處理 datarequested 事件時，您需要注意的最重要屬性是其 要求 屬性。 此屬性包含 DataRequest 物件。 您的應用程式會使用此物件來提供使用者想要與所選目標應用程式共用的資料。