Condividi tramite

Procedura: Estendere il walkthrough asincrono utilizzando Task.WhenAll (Visual Basic)

È possibile migliorare le prestazioni della soluzione asincrona nella procedura dettagliata: Accesso al Web tramite Async e Await (Visual Basic) usando il metodo . Questo metodo attende in modo asincrono più operazioni asincrone, rappresentate come una raccolta di attività.

Potresti aver notato nella procedura dettagliata che i siti Web scaricano a velocità diverse. A volte uno dei siti Web è molto lento, che ritarda tutti i download rimanenti. Quando si eseguono le soluzioni asincrone compilate nella procedura dettagliata, è possibile terminare facilmente il programma se non si vuole attendere, ma un'opzione migliore consiste nell'avviare tutti i download contemporaneamente e lasciare che i download più veloci continuino senza attendere quello ritardato.

Applichi il metodo Task.WhenAll a una raccolta di attività. L'applicazione di WhenAll restituisce un singolo task che non è completo finché ogni attività nella raccolta non è completata. Le attività vengono eseguite in parallelo, ma non vengono creati thread aggiuntivi. Le attività possono essere completate in qualsiasi ordine.

Importante

Le procedure seguenti descrivono le estensioni alle applicazioni asincrone sviluppate in Procedura dettagliata: Accesso al Web tramite Async e Await (Visual Basic). È possibile sviluppare le applicazioni completando la procedura dettagliata o scaricando l'esempio dal browser di esempio .NET. Il codice di esempio si trova nel progetto SerialAsyncExample.

Per eseguire l'esempio, è necessario che Nel computer sia installato Visual Studio 2012 o versione successiva.

Per aggiungere Task.WhenAll alla soluzione GetURLContentsAsync

  1. Aggiungere il metodo ProcessURLAsync alla prima applicazione sviluppata in Procedura dettagliata: Accesso al Web tramite Async e Await (Visual Basic).

    • Se è stato scaricato il codice dagli esempi di codice per sviluppatori, aprire il progetto AsyncWalkthrough e quindi aggiungere ProcessURLAsync al file MainWindow.xaml.vb.

    • Se hai sviluppato il codice completando la procedura dettagliata, aggiungi ProcessURLAsync all'applicazione che include il metodo GetURLContentsAsync. Il file di MainWindow.xaml.vb per questa applicazione è il primo esempio nella sezione "Complete Code Examples from the Walkthrough".

    Il ProcessURLAsync metodo consolida le azioni nel corpo del ciclo For Each nella SumPageSizesAsync procedura dettagliata originale. Il metodo scarica in modo asincrono il contenuto di un sito Web specificato come matrice di byte e quindi visualizza e restituisce la lunghezza della matrice di byte.

    Private Async Function ProcessURLAsync(url As String) As Task(Of Integer)

    Dim byteArray = Await GetURLContentsAsync(url)
    DisplayResults(url, byteArray)
    Return byteArray.Length
End Function

  2. Imposta come commento o elimina il For Each ciclo in SumPageSizesAsync, come mostrato nel codice seguente.

    'Dim total = 0
'For Each url In urlList

'    Dim urlContents As Byte() = Await GetURLContentsAsync(url)

'    ' The previous line abbreviates the following two assignment statements.

'    ' GetURLContentsAsync returns a task. At completion, the task
'    ' produces a byte array.
'    'Dim getContentsTask As Task(Of Byte()) = GetURLContentsAsync(url)
'    'Dim urlContents As Byte() = Await getContentsTask

'    DisplayResults(url, urlContents)

'    ' Update the total.
'    total += urlContents.Length
'Next

  3. Creare una raccolta di attività. Il codice seguente definisce una query che, quando eseguita dal ToArray metodo , crea una raccolta di attività che scaricano il contenuto di ogni sito Web. Le attività vengono avviate quando viene valutata la query.

    Aggiungere il codice seguente al metodo SumPageSizesAsync dopo la dichiarazione di urlList.

    ' Create a query.
Dim downloadTasksQuery As IEnumerable(Of Task(Of Integer)) =
    From url In urlList Select ProcessURLAsync(url)

' Use ToArray to execute the query and start the download tasks.
Dim downloadTasks As Task(Of Integer)() = downloadTasksQuery.ToArray()

  4. Applicare Task.WhenAll alla raccolta di attività, downloadTasks. Task.WhenAll restituisce una singola attività che termina quando tutte le attività nella raccolta di attività sono state completate.

    Nell'esempio seguente l'espressione Await attende il completamento della singola attività che WhenAll restituisce. L'espressione restituisce una matrice di numeri interi, in cui ogni intero è la lunghezza di un sito Web scaricato. Aggiungere il codice seguente a SumPageSizesAsync, subito dopo il codice aggiunto nel passaggio precedente.

    ' Await the completion of all the running tasks.
Dim lengths As Integer() = Await Task.WhenAll(downloadTasks)

'' The previous line is equivalent to the following two statements.
'Dim whenAllTask As Task(Of Integer()) = Task.WhenAll(downloadTasks)
'Dim lengths As Integer() = Await whenAllTask

  5. Infine, utilizzare il Sum metodo per calcolare la somma delle lunghezze di tutti i siti Web. Aggiungere la riga seguente a SumPageSizesAsync.

    Dim total = lengths.Sum()

Per aggiungere Task.WhenAll alla soluzione HttpClient.GetByteArrayAsync

  1. aggiungere la seguente versione di ProcessURLAsync alla seconda applicazione sviluppata in Procedura dettagliata: Accesso al Web tramite Async e Await (Visual Basic).

    • Se è stato scaricato il codice dagli esempi di codice per sviluppatori, aprire il progetto AsyncWalkthrough_HttpClient e quindi aggiungere ProcessURLAsync al file MainWindow.xaml.vb.

    • Se hai sviluppato il codice completando la procedura dettagliata, aggiungi ProcessURLAsync all'applicazione che usa il metodo HttpClient.GetByteArrayAsync. Il file di MainWindow.xaml.vb per questa applicazione è il secondo esempio nella sezione "Complete Code Examples from the Walkthrough".

    Il ProcessURLAsync metodo consolida le azioni nel corpo del ciclo For Each nella SumPageSizesAsync procedura dettagliata originale. Il metodo scarica in modo asincrono il contenuto di un sito Web specificato come matrice di byte e quindi visualizza e restituisce la lunghezza della matrice di byte.

    L'unica differenza rispetto al ProcessURLAsync metodo nella procedura precedente è l'uso dell'istanza HttpClient , client.

    Private Async Function ProcessURLAsync(url As String, client As HttpClient) As Task(Of Integer)

    Dim byteArray = Await client.GetByteArrayAsync(url)
    DisplayResults(url, byteArray)
    Return byteArray.Length
End Function

  2. Imposta come commento o elimina il For Each ciclo in SumPageSizesAsync, come mostrato nel codice seguente.

    'Dim total = 0
'For Each url In urlList
'    ' GetByteArrayAsync returns a task. At completion, the task
'    ' produces a byte array.
'    Dim urlContents As Byte() = Await client.GetByteArrayAsync(url)

'    ' The following two lines can replace the previous assignment statement.
'    'Dim getContentsTask As Task(Of Byte()) = client.GetByteArrayAsync(url)
'    'Dim urlContents As Byte() = Await getContentsTask

'    DisplayResults(url, urlContents)

'    ' Update the total.
'    total += urlContents.Length
'Next

  3. Definire una query che, quando eseguita dal ToArray metodo , crea una raccolta di attività che scaricano il contenuto di ogni sito Web. Le attività vengono avviate quando viene valutata la query.

    Aggiungere il codice seguente al metodo SumPageSizesAsync dopo la dichiarazione di client e urlList.

    ' Create a query.
Dim downloadTasksQuery As IEnumerable(Of Task(Of Integer)) =
    From url In urlList Select ProcessURLAsync(url, client)

' Use ToArray to execute the query and start the download tasks.
Dim downloadTasks As Task(Of Integer)() = downloadTasksQuery.ToArray()

  4. Successivamente, applicare Task.WhenAll alla raccolta di attività, downloadTasks. Task.WhenAll restituisce una singola attività che termina quando tutte le attività nella raccolta di attività sono state completate.

    Nell'esempio seguente l'espressione Await attende il completamento della singola attività che WhenAll restituisce. Al termine, l'espressione Await restituisce una matrice di numeri interi, in cui ogni intero è la lunghezza di un sito Web scaricato. Aggiungere il codice seguente a SumPageSizesAsync, subito dopo il codice aggiunto nel passaggio precedente.

    ' Await the completion of all the running tasks.
Dim lengths As Integer() = Await Task.WhenAll(downloadTasks)

'' The previous line is equivalent to the following two statements.
'Dim whenAllTask As Task(Of Integer()) = Task.WhenAll(downloadTasks)
'Dim lengths As Integer() = Await whenAllTask

  5. Infine, usare il Sum metodo per ottenere la somma delle lunghezze di tutti i siti Web. Aggiungere la riga seguente a SumPageSizesAsync.

    Dim total = lengths.Sum()

Per testare le soluzioni Task.WhenAll

Per entrambe le soluzioni, scegliere il tasto F5 per eseguire il programma e quindi scegliere il pulsante Start . L'output dovrebbe essere simile all'output delle soluzioni asincrone in Procedura dettagliata: Accesso al Web tramite Async e Await (Visual Basic). Tuttavia, si noti che i siti Web vengono visualizzati in un ordine diverso ogni volta.

Esempio 1

Il codice seguente illustra le estensioni del progetto che usa il GetURLContentsAsync metodo per scaricare il contenuto dal Web.

' Add the following Imports statements, and add a reference for System.Net.Http.
Imports System.Net.Http
Imports System.Net
Imports System.IO

Class MainWindow

    Async Sub startButton_Click(sender As Object, e As RoutedEventArgs) Handles startButton.Click

        resultsTextBox.Clear()

        ' One-step async call.
        Await SumPageSizesAsync()

        '' Two-step async call.
        'Dim sumTask As Task = SumPageSizesAsync()
        'Await sumTask

        resultsTextBox.Text &= vbCrLf & "Control returned to button1_Click."
    End Sub

    Private Async Function SumPageSizesAsync() As Task

        ' Make a list of web addresses.
        Dim urlList As List(Of String) = SetUpURLList()

        ' Create a query.
        Dim downloadTasksQuery As IEnumerable(Of Task(Of Integer)) =
            From url In urlList Select ProcessURLAsync(url)

        ' Use ToArray to execute the query and start the download tasks.
        Dim downloadTasks As Task(Of Integer)() = downloadTasksQuery.ToArray()

        ' You can do other work here before awaiting.

        ' Await the completion of all the running tasks.
        Dim lengths As Integer() = Await Task.WhenAll(downloadTasks)

        '' The previous line is equivalent to the following two statements.
        'Dim whenAllTask As Task(Of Integer()) = Task.WhenAll(downloadTasks)
        'Dim lengths As Integer() = Await whenAllTask

        Dim total = lengths.Sum()

        'Dim total = 0
        'For Each url In urlList

        '    Dim urlContents As Byte() = Await GetURLContentsAsync(url)

        '    ' The previous line abbreviates the following two assignment statements.

        '    ' GetURLContentsAsync returns a task. At completion, the task
        '    ' produces a byte array.
        '    'Dim getContentsTask As Task(Of Byte()) = GetURLContentsAsync(url)
        '    'Dim urlContents As Byte() = Await getContentsTask

        '    DisplayResults(url, urlContents)

        '    ' Update the total.
        '    total += urlContents.Length
        'NextNext

        ' Display the total count for all of the web addresses.
        resultsTextBox.Text &= String.Format(vbCrLf & vbCrLf &
                                             "Total bytes returned:  {0}" & vbCrLf, total)
    End Function

    Private Function SetUpURLList() As List(Of String)

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

    ' The actions from the foreach loop are moved to this async method.
    Private Async Function ProcessURLAsync(url As String) As Task(Of Integer)

        Dim byteArray = Await GetURLContentsAsync(url)
        DisplayResults(url, byteArray)
        Return byteArray.Length
    End Function

    Private Async Function GetURLContentsAsync(url As String) As Task(Of Byte())

        ' The downloaded resource ends up in the variable named content.
        Dim content = New MemoryStream()

        ' Initialize an HttpWebRequest for the current URL.
        Dim webReq = CType(WebRequest.Create(url), HttpWebRequest)

        ' Send the request to the Internet resource and wait for
        ' the response.
        Using response As WebResponse = Await webReq.GetResponseAsync()
            ' Get the data stream that is associated with the specified URL.
            Using responseStream As Stream = response.GetResponseStream()
                ' Read the bytes in responseStream and copy them to content.
                ' CopyToAsync returns a Task, not a Task<T>.
                Await responseStream.CopyToAsync(content)
            End Using
        End Using

        ' Return the result as a byte array.
        Return content.ToArray()
    End Function

    Private Sub DisplayResults(url As String, content As Byte())

        ' Display the length of each website. The string format
        ' is designed to be used with a monospaced font, such as
        ' Lucida Console or Global Monospace.
        Dim bytes = content.Length
        ' Strip off the "https://".
        Dim displayURL = url.Replace("https://", "")
        resultsTextBox.Text &= String.Format(vbCrLf & "{0,-58} {1,8}", displayURL, bytes)
    End Sub

End Class

Esempio 2

Il codice seguente illustra le estensioni al progetto che usa il metodo HttpClient.GetByteArrayAsync per scaricare il contenuto dal Web.

' Add the following Imports statements, and add a reference for System.Net.Http.
Imports System.Net.Http
Imports System.Net
Imports System.IO

Class MainWindow

    Async Sub startButton_Click(sender As Object, e As RoutedEventArgs) Handles startButton.Click

        resultsTextBox.Clear()

        '' One-step async call.
        Await SumPageSizesAsync()

        '' Two-step async call.
        'Dim sumTask As Task = SumPageSizesAsync()
        'Await sumTask

        resultsTextBox.Text &= vbCrLf & "Control returned to button1_Click."
    End Sub

    Private Async Function SumPageSizesAsync() As Task

        ' Declare an HttpClient object and increase the buffer size. The
        ' default buffer size is 65,536.
        Dim client As HttpClient =
            New HttpClient() With {.MaxResponseContentBufferSize = 1000000}

        ' Make a list of web addresses.
        Dim urlList As List(Of String) = SetUpURLList()

        ' Create a query.
        Dim downloadTasksQuery As IEnumerable(Of Task(Of Integer)) =
            From url In urlList Select ProcessURLAsync(url, client)

        ' Use ToArray to execute the query and start the download tasks.
        Dim downloadTasks As Task(Of Integer)() = downloadTasksQuery.ToArray()

        ' You can do other work here before awaiting.

        ' Await the completion of all the running tasks.
        Dim lengths As Integer() = Await Task.WhenAll(downloadTasks)

        '' The previous line is equivalent to the following two statements.
        'Dim whenAllTask As Task(Of Integer()) = Task.WhenAll(downloadTasks)
        'Dim lengths As Integer() = Await whenAllTask

        Dim total = lengths.Sum()

        ''<snippet7>
        'Dim total = 0
        'For Each url In urlList
        '    ' GetByteArrayAsync returns a task. At completion, the task
        '    ' produces a byte array.
        '    '<snippet31>
        '    Dim urlContents As Byte() = Await client.GetByteArrayAsync(url)
        '    '</snippet31>

        '    ' The following two lines can replace the previous assignment statement.
        '    'Dim getContentsTask As Task(Of Byte()) = client.GetByteArrayAsync(url)
        '    'Dim urlContents As Byte() = Await getContentsTask

        '    DisplayResults(url, urlContents)

        '    ' Update the total.
        '    total += urlContents.Length
        'NextNext

        ' Display the total count for all of the web addresses.
        resultsTextBox.Text &= String.Format(vbCrLf & vbCrLf &
                                             "Total bytes returned:  {0}" & vbCrLf, total)
    End Function

    Private Function SetUpURLList() As List(Of String)

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

    Private Async Function ProcessURLAsync(url As String, client As HttpClient) As Task(Of Integer)

        Dim byteArray = Await client.GetByteArrayAsync(url)
        DisplayResults(url, byteArray)
        Return byteArray.Length
    End Function

    Private Sub DisplayResults(url As String, content As Byte())

        ' Display the length of each website. The string format
        ' is designed to be used with a monospaced font, such as
        ' Lucida Console or Global Monospace.
        Dim bytes = content.Length
        ' Strip off the "https://".
        Dim displayURL = url.Replace("https://", "")
        resultsTextBox.Text &= String.Format(vbCrLf & "{0,-58} {1,8}", displayURL, bytes)
    End Sub

End Class

Vedere anche

  • Last updated on