Eine Aufgabe oder Aufgabenliste abbrechen (C# und Visual Basic)

Artikel
03/12/2013

Sie können eine Schaltfläche installieren, die Sie verwenden können, um eine asynchrone Anwendung abzubrechen, wenn Sie nicht darauf warten möchten, um zu beenden.Mit den Beispielen in diesem Thema folgen, können Sie eine Abbruchsschaltfläche einer Anwendung hinzufügen, die den Inhalt von einer Website oder einer Liste von Websites herunterladen.

Die Beispiele verwenden die Benutzeroberfläche, die Feinabstimmung der Async-Anwendung (C# und Visual Basic) beschreibt.

Hinweis
Um die Beispiele auszuführen, müssen Sie Visual Studio 2012, Visual Studio Express 2012 für Windows Desktop oder .NET Framework 4.5 enthalten, das auf dem Computer installiert ist.

Brechen Sie eine Aufgabe ab

Im ersten Beispiel wird die Schaltfläche Abbrechen mit einer einzelnen Downloadaufgabe zu.Wenn Sie die Schaltfläche auswählen, während die Anwendung Inhalt herunterladen, wird der Download abgebrochen.

Herunterladen des Beispiels

Sie können das gesamte Projekt (Windows Presentation Foundation) von Asynchrones Beispiel: Abstimmen der Anwendung herunterladen und dann diesen Schritten folgen.

Dekomprimieren Sie die Datei, die Sie heruntergeladen haben, und starten Sie dann Visual Studio 2012.
Klicken Sie in der Menüleiste auf Datei, dann auf Öffnen und Projekt/Projektmappe.
Im Dialogfeld Projekt öffnen öffnen Sie den Ordner, der den Beispielcode enthält, den Sie dekomprimierten und dann die Projektmappendatei (.sln) für AsyncFineTuningCS oder AsyncFineTuningVB öffnet.
In Projektmappen-Explorer öffnen Sie das Kontextmenü für das CancelATask Projekt, und wählen Sie dann Als Startprojekt festlegen aus.
Wählen Sie die F5-TASTE, um das Projekt auszuführen.

Wählen Sie die STRG+F5-Tasten, um das Projekt auszuführen, ohne es zu debuggen.

Wenn Sie nicht das Projekt herunterladen möchten, können Sie die MainWindow.xaml.vb- und MainWindow.xaml.cs-Dateien am Ende dieses Themas überprüfen.

Erstellen des Beispiels

Die folgenden Änderungen fügen eine Schaltfläche Abbrechen einer Anwendung hinzu, die eine Website herunterladen.Wenn Sie nicht das Beispiel herunterladen oder erstellen möchten, können Sie das Endprodukt im Abschnitt "Beispiele" vollständigen am Ende dieses Themas überprüfen.Sternchen kennzeichnen die Änderungen im Code.

Um das Beispiel zu erstellen, sich schrittweise, folgen Sie den Anweisungen im Abschnitt" Beispiel "Download, aber wählen StarterCode als Startprojekt anstelle CancelATask aus.

Fügen Sie dann die folgenden Änderungen an der MainWindow.xaml.vb- oder "MainWindow.xaml.cs" dieses Projekts.

Deklarieren Sie eine Variable CancellationTokenSource, cts, die im Bereich für alle Methoden ist, die darauf zugreifen.

Class MainWindow

    ' ***Declare a System.Threading.CancellationTokenSource.
    Dim cts As CancellationTokenSource

public partial class MainWindow : Window
{
    // ***Declare a System.Threading.CancellationTokenSource.
    CancellationTokenSource cts;

Fügen Sie den folgenden - Ereignishandler für die Schaltfläche Abbrechen hinzu.Der Ereignishandler CancellationTokenSource.Cancel verwendet die - Methode, um cts zu benachrichtigen wenn der Benutzeranforderungsabbruch.

' ***Add an event handler for the Cancel button.
Private Sub cancelButton_Click(sender As Object, e As RoutedEventArgs)

    If cts IsNot Nothing Then
        cts.Cancel()
    End If
End Sub

// ***Add an event handler for the Cancel button.
private void cancelButton_Click(object sender, RoutedEventArgs e)
{
    if (cts != null)
    {
        cts.Cancel();
    }
}

Führen Sie den folgenden Handler der Änderungen im - Ereignishandler für die Schaltfläche Start, startButton_Click.

Instanziieren Sie CancellationTokenSource, cts.

' ***Instantiate the CancellationTokenSource.
cts = New CancellationTokenSource()

// ***Instantiate the CancellationTokenSource.
cts = new CancellationTokenSource();

Im Aufruf von AccessTheWebAsync, der den Inhalt einer angegebenen Website herunterladen, senden Sie die CancellationTokenSource.Token-Eigenschaft von cts als Argument.Die Token-Eigenschaft gibt die Meldung, wenn Abbruch angefordert wird.Fügen Sie einen Catch-Block hinzu, der eine Meldung angezeigt wird, wenn der Benutzer die, um den Downloadvorgang abzubrechen.Der folgende Code zeigt die Änderungen an.

Try
    ' ***Send a token to carry the message if cancellation is requested.
    Dim contentLength As Integer = Await AccessTheWebAsync(cts.Token)

    resultsTextBox.Text &=
        String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, contentLength)

    ' *** If cancellation is requested, an OperationCanceledException results.
Catch ex As OperationCanceledException
    resultsTextBox.Text &= vbCrLf & "Download canceled." & vbCrLf

Catch ex As Exception
    resultsTextBox.Text &= vbCrLf & "Download failed." & vbCrLf
End Try

try
{
    // ***Send a token to carry the message if cancellation is requested.
    int contentLength = await AccessTheWebAsync(cts.Token);
    resultsTextBox.Text +=
        String.Format("\r\nLength of the downloaded string: {0}.\r\n", contentLength);
}
// *** If cancellation is requested, an OperationCanceledException results.
catch (OperationCanceledException)
{
    resultsTextBox.Text += "\r\nDownload canceled.\r\n";
}
catch (Exception)
{
    resultsTextBox.Text += "\r\nDownload failed.\r\n";
}

In AccessTheWebAsync verwenden Sie die HttpClient.GetAsync(String, CancellationToken) Überladung der - Methode GetAsync im HttpClient-Typ, um den Inhalt einer Website herunterzuladen.Führen Sie ct, den CancellationToken-Parameter von AccessTheWebAsync, als zweites Argument.Das Token enthält die Meldung, wenn der Benutzer die Schaltfläche Abbrechen auswählt.

Der folgende Code zeigt die Änderungen in AccessTheWebAsync an.

' ***Provide a parameter for the CancellationToken.
Async Function AccessTheWebAsync(ct As CancellationToken) As Task(Of Integer)

    Dim client As HttpClient = New HttpClient()

    resultsTextBox.Text &=
        String.Format(vbCrLf & "Ready to download." & vbCrLf)

    ' You might need to slow things down to have a chance to cancel.
    Await Task.Delay(250)

    ' GetAsync returns a Task(Of HttpResponseMessage). 
    ' ***The ct argument carries the message if the Cancel button is chosen.
    Dim response As HttpResponseMessage = Await client.GetAsync("https://msdn.microsoft.com/en-us/library/dd470362.aspx", ct)

    ' Retrieve the website contents from the HttpResponseMessage.
    Dim urlContents As Byte() = Await response.Content.ReadAsByteArrayAsync()

    ' The result of the method is the length of the downloaded website.
    Return urlContents.Length
End Function

// ***Provide a parameter for the CancellationToken.
async Task<int> AccessTheWebAsync(CancellationToken ct)
{
    HttpClient client = new HttpClient();

    resultsTextBox.Text +=
        String.Format("\r\nReady to download.\r\n");

    // You might need to slow things down to have a chance to cancel.
    await Task.Delay(250);

    // GetAsync returns a Task<HttpResponseMessage>. 
    // ***The ct argument carries the message if the Cancel button is chosen.
    HttpResponseMessage response = await client.GetAsync("https://msdn.microsoft.com/en-us/library/dd470362.aspx", ct);

    // Retrieve the website contents from the HttpResponseMessage.
    byte[] urlContents = await response.Content.ReadAsByteArrayAsync();

    // The result of the method is the length of the downloaded website.
    return urlContents.Length;
}

Wenn Sie nicht das Programm abbrechen, wird folgende Ausgabe erzeugt.
```
Ready to download.
Length of the downloaded string: 158125.
```
Wenn Sie die Schaltfläche Abbrechen auswählen, bevor das Programm beendet, den Inhalt herunterzuladen, erzeugt das Programm folgende Ausgabe.
```
Ready to download.
Download canceled.
```

Brechen Sie eine Liste der Aufgaben ab

Sie können das vorherige Beispiel erweitern, um viele Aufgaben abbrechen, indem Sie die gleiche Instanz CancellationTokenSource mit jeder Aufgabe zuordnen.Wenn Sie die Schaltfläche Abbrechen auswählen, brechen Sie alle Aufgaben ab, die noch nicht abgeschlossen wurden.

Herunterladen des Beispiels

Sie können das gesamte Projekt (Windows Presentation Foundation) von Asynchrones Beispiel: Abstimmen der Anwendung herunterladen und dann diesen Schritten folgen.

Dekomprimieren Sie die Datei, die Sie heruntergeladen haben, und starten Sie dann Visual Studio 2012.
Klicken Sie in der Menüleiste auf Datei, dann auf Öffnen und Projekt/Projektmappe.
Im Dialogfeld Projekt öffnen öffnen Sie den Ordner, der den Beispielcode enthält, den Sie dekomprimierten und dann die Projektmappendatei (.sln) für AsyncFineTuningCS oder AsyncFineTuningVB öffnet.
In Projektmappen-Explorer öffnen Sie das Kontextmenü für das CancelAListOfTasks Projekt, und wählen Sie dann Als Startprojekt festlegen aus.
Wählen Sie die F5-TASTE, um das Projekt auszuführen.

Wählen Sie die STRG+F5-Tasten, um das Projekt auszuführen, ohne es zu debuggen.

Wenn Sie nicht das Projekt herunterladen möchten, können Sie die MainWindow.xaml.vb- und MainWindow.xaml.cs-Dateien am Ende dieses Themas überprüfen.

Erstellen des Beispiels

Um das Beispiel zu erweitern, schrittweise, folgen Sie den Anweisungen im Abschnitt" Beispiel "Download, aber wählen CancelATask als Startprojekt aus.Fügen Sie die folgenden Änderungen an diesem Projekt hinzu.Sternchen kennzeichnen die Änderungen im Programm.

Fügen Sie eine Methode hinzu, um eine Liste von Webadressen zu erstellen.

' ***Add a method that creates a list of web addresses.
Private Function SetUpURLList() As List(Of String)

    Dim urls = New List(Of String) From
        {
            "https://msdn.microsoft.com",
            "https://msdn.microsoft.com/en-us/library/hh290138.aspx",
            "https://msdn.microsoft.com/en-us/library/hh290140.aspx",
            "https://msdn.microsoft.com/en-us/library/dd470362.aspx",
            "https://msdn.microsoft.com/en-us/library/aa578028.aspx",
            "https://msdn.microsoft.com/en-us/library/ms404677.aspx",
            "https://msdn.microsoft.com/en-us/library/ff730837.aspx"
        }
    Return urls
End Function

// ***Add a method that creates a list of web addresses.
private List<string> SetUpURLList()
{
    List<string> urls = new List<string> 
    { 
        "https://msdn.microsoft.com",
        "https://msdn.microsoft.com/en-us/library/hh290138.aspx",
        "https://msdn.microsoft.com/en-us/library/hh290140.aspx",
        "https://msdn.microsoft.com/en-us/library/dd470362.aspx",
        "https://msdn.microsoft.com/en-us/library/aa578028.aspx",
        "https://msdn.microsoft.com/en-us/library/ms404677.aspx",
        "https://msdn.microsoft.com/en-us/library/ff730837.aspx"
    };
    return urls;
}

Rufen Sie die - Methode in AccessTheWebAsync auf.

' ***Call SetUpURLList to make a list of web addresses.
Dim urlList As List(Of String) = SetUpURLList()

// ***Call SetUpURLList to make a list of web addresses.
List<string> urlList = SetUpURLList();

Fügen Sie die folgende - Schleife in AccessTheWebAsync hinzu, um jede Webadresse in der Liste zu verarbeiten.

' ***Add a loop to process the list of web addresses.
For Each url In urlList
    ' GetAsync returns a Task(Of HttpResponseMessage). 
    ' Argument ct carries the message if the Cancel button is chosen. 
    ' ***Note that the Cancel button can cancel all remaining downloads.
    Dim response As HttpResponseMessage = Await client.GetAsync(url, ct)

    ' Retrieve the website contents from the HttpResponseMessage.
    Dim urlContents As Byte() = Await response.Content.ReadAsByteArrayAsync()

    resultsTextBox.Text &=
        String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, urlContents.Length)
Next

// ***Add a loop to process the list of web addresses.
foreach (var url in urlList)
{
    // GetAsync returns a Task<HttpResponseMessage>. 
    // Argument ct carries the message if the Cancel button is chosen. 
    // ***Note that the Cancel button can cancel all remaining downloads.
    HttpResponseMessage response = await client.GetAsync(url, ct);

    // Retrieve the website contents from the HttpResponseMessage.
    byte[] urlContents = await response.Content.ReadAsByteArrayAsync();

    resultsTextBox.Text +=
        String.Format("\r\nLength of the downloaded string: {0}.\r\n", urlContents.Length);
}

Da AccessTheWebAsync die Längen anzeigt, muss die - Methode, um nichts zurückzugeben.Entfernen Sie die return-Anweisung und ändern Sie den Rückgabetyp der Methode zu Task anstelle Task<TResult>.
```
Async Function AccessTheWebAsync(ct As CancellationToken) As Task
```
```
async Task AccessTheWebAsync(CancellationToken ct)
```
Rufen Sie die - Methode von startButton_Click auf, indem Sie eine Anweisung anstelle eines Ausdrucks verwenden.
```
Await AccessTheWebAsync(cts.Token)
```
```
await AccessTheWebAsync(cts.Token);
```

Wenn Sie nicht das Programm abbrechen, wird folgende Ausgabe erzeugt.

Length of the downloaded string: 35939.

Length of the downloaded string: 237682.

Length of the downloaded string: 128607.

Length of the downloaded string: 158124.

Length of the downloaded string: 204890.

Length of the downloaded string: 175488.

Length of the downloaded string: 145790.

Downloads complete.

Wenn Sie die Schaltfläche Abbrechen auswählen, bevor Downloads abgeschlossen sind, enthält die Ausgabe die Längen der Downloads, die vor dem Abbruch haben.

Length of the downloaded string: 35939.

Length of the downloaded string: 237682.

Length of the downloaded string: 128607.

Downloads canceled.

Vollständige Beispiele

Die folgenden Abschnitte enthalten den Code für jedes der vorherigen Beispiele.Beachten Sie, dass Sie einen Verweis für System.Net.Http hinzufügen müssen.

Sie können Projekte von Asynchrones Beispiel: Abstimmen der Anwendung herunterladen.

Brechen Sie ein Aufgaben-Beispiel ab

Der folgende Code ist die vollständige MainWindow.xaml.vb- oder "MainWindow.xaml.cs" für das Beispiel, das eine einzelne Aufgabe abgebrochen wird.

' Add an Imports directive and a reference for System.Net.Http.
Imports System.Net.Http

' Add the following Imports directive for System.Threading.
Imports System.Threading

Class MainWindow

    ' ***Declare a System.Threading.CancellationTokenSource.
    Dim cts As CancellationTokenSource

    Private Async Sub startButton_Click(sender As Object, e As RoutedEventArgs)
        ' ***Instantiate the CancellationTokenSource.
        cts = New CancellationTokenSource()

        resultsTextBox.Clear()

        Try
            ' ***Send a token to carry the message if cancellation is requested.
            Dim contentLength As Integer = Await AccessTheWebAsync(cts.Token)

            resultsTextBox.Text &=
                String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, contentLength)

            ' *** If cancellation is requested, an OperationCanceledException results.
        Catch ex As OperationCanceledException
            resultsTextBox.Text &= vbCrLf & "Download canceled." & vbCrLf

        Catch ex As Exception
            resultsTextBox.Text &= vbCrLf & "Download failed." & vbCrLf
        End Try

        ' ***Set the CancellationTokenSource to Nothing when the download is complete.
        cts = Nothing
    End Sub

    ' ***Add an event handler for the Cancel button.
    Private Sub cancelButton_Click(sender As Object, e As RoutedEventArgs)

        If cts IsNot Nothing Then
            cts.Cancel()
        End If
    End Sub

    ' ***Provide a parameter for the CancellationToken.
    Async Function AccessTheWebAsync(ct As CancellationToken) As Task(Of Integer)

        Dim client As HttpClient = New HttpClient()

        resultsTextBox.Text &=
            String.Format(vbCrLf & "Ready to download." & vbCrLf)

        ' You might need to slow things down to have a chance to cancel.
        Await Task.Delay(250)

        ' GetAsync returns a Task(Of HttpResponseMessage). 
        ' ***The ct argument carries the message if the Cancel button is chosen.
        Dim response As HttpResponseMessage = Await client.GetAsync("https://msdn.microsoft.com/en-us/library/dd470362.aspx", ct)

        ' Retrieve the website contents from the HttpResponseMessage.
        Dim urlContents As Byte() = Await response.Content.ReadAsByteArrayAsync()

        ' The result of the method is the length of the downloaded website.
        Return urlContents.Length
    End Function
End Class


' Output for a successful download:

' Ready to download.

' Length of the downloaded string: 158125.


' Or, if you cancel:

' Ready to download.

' Download canceled.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

// Add a using directive and a reference for System.Net.Http.
using System.Net.Http;

// Add the following using directive for System.Threading.

using System.Threading;
namespace CancelATask
{
    public partial class MainWindow : Window
    {
        // ***Declare a System.Threading.CancellationTokenSource.
        CancellationTokenSource cts;

        public MainWindow()
        {
            InitializeComponent();
        }


        private async void startButton_Click(object sender, RoutedEventArgs e)
        {
            // ***Instantiate the CancellationTokenSource.
            cts = new CancellationTokenSource();

            resultsTextBox.Clear();

            try
            {
                // ***Send a token to carry the message if cancellation is requested.
                int contentLength = await AccessTheWebAsync(cts.Token);
                resultsTextBox.Text +=
                    String.Format("\r\nLength of the downloaded string: {0}.\r\n", contentLength);
            }
            // *** If cancellation is requested, an OperationCanceledException results.
            catch (OperationCanceledException)
            {
                resultsTextBox.Text += "\r\nDownload canceled.\r\n";
            }
            catch (Exception)
            {
                resultsTextBox.Text += "\r\nDownload failed.\r\n";
            }

            // ***Set the CancellationTokenSource to null when the download is complete.
            cts = null; 
        }


        // ***Add an event handler for the Cancel button.
        private void cancelButton_Click(object sender, RoutedEventArgs e)
        {
            if (cts != null)
            {
                cts.Cancel();
            }
        }


        // ***Provide a parameter for the CancellationToken.
        async Task<int> AccessTheWebAsync(CancellationToken ct)
        {
            HttpClient client = new HttpClient();

            resultsTextBox.Text +=
                String.Format("\r\nReady to download.\r\n");

            // You might need to slow things down to have a chance to cancel.
            await Task.Delay(250);

            // GetAsync returns a Task<HttpResponseMessage>. 
            // ***The ct argument carries the message if the Cancel button is chosen.
            HttpResponseMessage response = await client.GetAsync("https://msdn.microsoft.com/en-us/library/dd470362.aspx", ct);

            // Retrieve the website contents from the HttpResponseMessage.
            byte[] urlContents = await response.Content.ReadAsByteArrayAsync();

            // The result of the method is the length of the downloaded website.
            return urlContents.Length;
        }
    }

    // Output for a successful download:

    // Ready to download.

    // Length of the downloaded string: 158125.


    // Or, if you cancel:

    // Ready to download.

    // Download canceled.
}

Brechen Sie eine Liste der Aufgaben-Beispiels ab

Der folgende Code ist die vollständige MainWindow.xaml.vb- oder "MainWindow.xaml.cs" für das Beispiel, das eine Liste von Aufgaben abgebrochen werden.

' Add an Imports directive and a reference for System.Net.Http.
Imports System.Net.Http

' Add the following Imports directive for System.Threading.
Imports System.Threading

Class MainWindow

    ' Declare a System.Threading.CancellationTokenSource.
    Dim cts As CancellationTokenSource


    Private Async Sub startButton_Click(sender As Object, e As RoutedEventArgs)

        ' Instantiate the CancellationTokenSource.
        cts = New CancellationTokenSource()

        resultsTextBox.Clear()

        Try
            ' ***AccessTheWebAsync returns a Task, not a Task(Of Integer).
            Await AccessTheWebAsync(cts.Token)
            '  ***Small change in the display lines.
            resultsTextBox.Text &= vbCrLf & "Downloads complete."

        Catch ex As OperationCanceledException
            resultsTextBox.Text &= vbCrLf & "Downloads canceled." & vbCrLf

        Catch ex As Exception
            resultsTextBox.Text &= vbCrLf & "Downloads failed." & vbCrLf
        End Try

        ' Set the CancellationTokenSource to Nothing when the download is complete.
        cts = Nothing
    End Sub


    ' Add an event handler for the Cancel button.
    Private Sub cancelButton_Click(sender As Object, e As RoutedEventArgs)

        If cts IsNot Nothing Then
            cts.Cancel()
        End If
    End Sub


    ' Provide a parameter for the CancellationToken.
    ' ***Change the return type to Task because the method has no return statement.
    Async Function AccessTheWebAsync(ct As CancellationToken) As Task

        Dim client As HttpClient = New HttpClient()

        ' ***Call SetUpURLList to make a list of web addresses.
        Dim urlList As List(Of String) = SetUpURLList()

        ' ***Add a loop to process the list of web addresses.
        For Each url In urlList
            ' GetAsync returns a Task(Of HttpResponseMessage). 
            ' Argument ct carries the message if the Cancel button is chosen. 
            ' ***Note that the Cancel button can cancel all remaining downloads.
            Dim response As HttpResponseMessage = Await client.GetAsync(url, ct)

            ' Retrieve the website contents from the HttpResponseMessage.
            Dim urlContents As Byte() = Await response.Content.ReadAsByteArrayAsync()

            resultsTextBox.Text &=
                String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, urlContents.Length)
        Next
    End Function


    ' ***Add a method that creates a list of web addresses.
    Private Function SetUpURLList() As List(Of String)

        Dim urls = New List(Of String) From
            {
                "https://msdn.microsoft.com",
                "https://msdn.microsoft.com/en-us/library/hh290138.aspx",
                "https://msdn.microsoft.com/en-us/library/hh290140.aspx",
                "https://msdn.microsoft.com/en-us/library/dd470362.aspx",
                "https://msdn.microsoft.com/en-us/library/aa578028.aspx",
                "https://msdn.microsoft.com/en-us/library/ms404677.aspx",
                "https://msdn.microsoft.com/en-us/library/ff730837.aspx"
            }
        Return urls
    End Function

End Class


' Output if you do not choose to cancel:

' Length of the downloaded string: 35939.

' Length of the downloaded string: 237682.

' Length of the downloaded string: 128607.

' Length of the downloaded string: 158124.

' Length of the downloaded string: 204890.

' Length of the downloaded string: 175488.

' Length of the downloaded string: 145790.

' Downloads complete.


'  Sample output if you choose to cancel:

' Length of the downloaded string: 35939.

' Length of the downloaded string: 237682.

' Length of the downloaded string: 128607.

' Downloads canceled.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

// Add a using directive and a reference for System.Net.Http.
using System.Net.Http;

// Add the following using directive for System.Threading.
using System.Threading;

namespace CancelAListOfTasks
{
    public partial class MainWindow : Window
    {
        // Declare a System.Threading.CancellationTokenSource.
        CancellationTokenSource cts;

        public MainWindow()
        {
            InitializeComponent();
        }


        private async void startButton_Click(object sender, RoutedEventArgs e)
        {
            // Instantiate the CancellationTokenSource.
            cts = new CancellationTokenSource();

            resultsTextBox.Clear();

            try
            {
                await AccessTheWebAsync(cts.Token);
                // ***Small change in the display lines.
                resultsTextBox.Text += "\r\nDownloads complete.";
            }
            catch (OperationCanceledException)
            {
                resultsTextBox.Text += "\r\nDownloads canceled.";
            }
            catch (Exception)
            {
                resultsTextBox.Text += "\r\nDownloads failed.";
            }

            // Set the CancellationTokenSource to null when the download is complete.
            cts = null;
        }


        // Add an event handler for the Cancel button.
        private void cancelButton_Click(object sender, RoutedEventArgs e)
        {
            if (cts != null)
            {
                cts.Cancel();
            }
        }


        // Provide a parameter for the CancellationToken.
        // ***Change the return type to Task because the method has no return statement.
        async Task AccessTheWebAsync(CancellationToken ct)
        {
            // Declare an HttpClient object.
            HttpClient client = new HttpClient();

            // ***Call SetUpURLList to make a list of web addresses.
            List<string> urlList = SetUpURLList();

            // ***Add a loop to process the list of web addresses.
            foreach (var url in urlList)
            {
                // GetAsync returns a Task<HttpResponseMessage>. 
                // Argument ct carries the message if the Cancel button is chosen. 
                // ***Note that the Cancel button can cancel all remaining downloads.
                HttpResponseMessage response = await client.GetAsync(url, ct);

                // Retrieve the website contents from the HttpResponseMessage.
                byte[] urlContents = await response.Content.ReadAsByteArrayAsync();

                resultsTextBox.Text +=
                    String.Format("\r\nLength of the downloaded string: {0}.\r\n", urlContents.Length);
            }
        }


        // ***Add a method that creates a list of web addresses.
        private List<string> SetUpURLList()
        {
            List<string> urls = new List<string> 
            { 
                "https://msdn.microsoft.com",
                "https://msdn.microsoft.com/en-us/library/hh290138.aspx",
                "https://msdn.microsoft.com/en-us/library/hh290140.aspx",
                "https://msdn.microsoft.com/en-us/library/dd470362.aspx",
                "https://msdn.microsoft.com/en-us/library/aa578028.aspx",
                "https://msdn.microsoft.com/en-us/library/ms404677.aspx",
                "https://msdn.microsoft.com/en-us/library/ff730837.aspx"
            };
            return urls;
        }
    }

    // Output if you do not choose to cancel:

    //Length of the downloaded string: 35939.

    //Length of the downloaded string: 237682.

    //Length of the downloaded string: 128607.

    //Length of the downloaded string: 158124.

    //Length of the downloaded string: 204890.

    //Length of the downloaded string: 175488.

    //Length of the downloaded string: 145790.

    //Downloads complete.


    // Sample output if you choose to cancel:

    //Length of the downloaded string: 35939.

    //Length of the downloaded string: 237682.

    //Length of the downloaded string: 128607.

    //Downloads canceled.
}

Siehe auch

Freigeben über

Eine Aufgabe oder Aufgabenliste abbrechen (C# und Visual Basic)

Brechen Sie eine Aufgabe ab

Herunterladen des Beispiels

Erstellen des Beispiels

Brechen Sie eine Liste der Aufgaben ab

Herunterladen des Beispiels

Erstellen des Beispiels

Vollständige Beispiele

Brechen Sie ein Aufgaben-Beispiel ab

Brechen Sie eine Liste der Aufgaben-Beispiels ab

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen