WebView.DataTransferPackage Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Hinweis

DataTransferPackage kann nach Windows 8.1 geändert oder für Releases nicht mehr verfügbar sein. Verwenden Sie stattdessen CaptureSelectedContentToDataPackageAsync.

Ruft ein DataPackage-Zwischenablage ab, wie es an die WebView übergeben wird.

public:
 property DataPackage ^ DataTransferPackage { DataPackage ^ get(); };

/// [get: Windows.Foundation.Metadata.Deprecated("Use CaptureSelectedContentToDataPackageAsync instead of DataTransferPackage. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
DataPackage DataTransferPackage();

public DataPackage DataTransferPackage { [Windows.Foundation.Metadata.Deprecated("Use CaptureSelectedContentToDataPackageAsync instead of DataTransferPackage. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")] get; }

var dataPackage = webView.dataTransferPackage;

Public ReadOnly Property DataTransferPackage As DataPackage

Eigenschaftswert

DataPackage

Ein Zwischenablagedatenpaket.

Attribute

DeprecatedAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Eigenschaft verwendet wird, um die Freigabeunterstützung zu implementieren.

void SDKSample::WebViewControl::Scenario7::Share_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
    dataTransferManager = DataTransferManager::GetForCurrentView();
    dataRequestedToken = dataTransferManager->DataRequested += ref new TypedEventHandler<DataTransferManager^, DataRequestedEventArgs^>(this, &Scenario7::dataTransferManager_DataRequested);
    DataTransferManager::ShowShareUI();
}

// Data requested handler
void SDKSample::WebViewControl::Scenario7::dataTransferManager_DataRequested(DataTransferManager^ sender, DataRequestedEventArgs^ args)
{
    DataRequest^ request = args->Request;
    DataPackage^ p = WebView7->DataTransferPackage;
    
    if (p->GetView()->Contains(StandardDataFormats::Text))
    {
        p->Properties->Title = "WebView Sharing Excerpt";
        p->Properties->Description = "This is a snippet from the content hosted in the WebView control";
        request->Data = p;
    }
    else
    {
        request->FailWithDisplayText("Nothing to share");
    }
    dataTransferManager->DataRequested -= dataRequestedToken;
}

private void Share_Click(object sender, RoutedEventArgs e)
{
    dataTransferManager = DataTransferManager.GetForCurrentView();
    dataTransferManager.DataRequested += dataTransferManager_DataRequested;
    DataTransferManager.ShowShareUI();
}

void dataTransferManager_DataRequested(DataTransferManager sender, DataRequestedEventArgs args)
{
    DataRequest request = args.Request;
    DataPackage p = WebView7.DataTransferPackage;

    if (p.GetView().Contains(StandardDataFormats.Text))
    {
        p.Properties.Title = "WebView Sharing Excerpt";
        p.Properties.Description = "This is a snippet from the content hosted in the WebView control";
        request.Data = p;
    }
    else
    {
        request.FailWithDisplayText("Nothing to share");
    }
    dataTransferManager.DataRequested -= dataTransferManager_DataRequested;
}

Private Sub Share_Click(sender As Object, e As RoutedEventArgs)
    dataTransferManager = dataTransferManager.GetForCurrentView()
    AddHandler dataTransferManager.DataRequested, AddressOf dataTransferManager_DataRequested
    dataTransferManager.ShowShareUI()
End Sub

Private Sub dataTransferManager_DataRequested(sender As DataTransferManager, args As DataRequestedEventArgs)
    Dim request As DataRequest = args.Request
    Dim p As DataPackage = WebView7.DataTransferPackage

    If p.GetView().Contains(StandardDataFormats.Text) Then
        p.Properties.Title = "WebView Sharing Excerpt"
        p.Properties.Description = "This is a snippet from the content hosted in the WebView control"
        request.Data = p
    Else
        request.FailWithDisplayText("Nothing to share")
    End If
    RemoveHandler dataTransferManager.DataRequested, AddressOf dataTransferManager_DataRequested
End Sub

Hinweise

Diese Eigenschaft wird in der Regel verwendet, um die Freigabe zu unterstützen. Während eines Freigabevorgangs platziert die Quell-App die freigegebenen Daten in einem DataPackage-Objekt und sendet dieses Objekt zur Verarbeitung an die Ziel-App.

Weitere Informationen

• Beispiel für XAML-WebView-Steuerelement