оператор await можно использовать только в методах с модификатором async
Оператор await (справочник по C#)
Оператор await приостанавливает вычисление включающего асинхронного метода до завершения асинхронной операции, представленной его операндом. После завершения асинхронной операции оператор await возвращает результат операции, если таковой имеется. Когда оператор await применяется к операнду, который представляет уже завершенную операцию, он возвращает результат операции немедленно без приостановки включающего метода. Оператор await не блокирует поток, который вычисляет асинхронный метод. Когда оператор await приостанавливает включающий метод async, элемент управления возвращается вызывающему объекту метода.
Общие сведения об асинхронном программировании см. в разделе Асинхронное программирование с использованием ключевых слов async и await. Асинхронное программирование async и await следует асинхронной модели, основанной на задачах.
Оператор await можно использовать только в методе, лямбда-выражении или в анонимном методе, изменяемом ключевым словом async. В асинхронном методе нельзя использовать оператор await в теле синхронной функции, внутри блока инструкции lock и в ненадежном контексте.
Ключевые слова async и await доступны, начиная с версии C# 5.
Асинхронные потоки и освобождаемые объекты
Начиная с версии C# 8.0 вы можете работать с асинхронными потоками и освобождаемыми объектами.
Вы можете использовать инструкцию await foreach для работы с асинхронным потоком данных. Дополнительные сведения см. в разделе Инструкция foreach статьи Инструкции итерации и разделе Асинхронные потоки статьи Новые возможности в C# 8.0.
Инструкция await using используется для работы с асинхронно освобождаемым объектом, то есть с объектом типа, который реализует интерфейс IAsyncDisposable. Дополнительные сведения см. в разделе Использование асинхронных освобождаемых объектов статьи Реализация метода DisposeAsync.
Оператор await в методе Main
Спецификация языка C#
Дополнительные сведения см. в разделе об ожидаемых выражениях в спецификации языка C#.
Оператор await можно использовать только в методах с модификатором async
Здравствуйте, нашел хороший геокодер, но не смог в нем разобраться даже при наличии примера. (вставил кусок из примера к себе в код)
Но выходит ошибка
Оператор await можно использовать только в методах с модификатором async. Попробуйте пометить этот метод модификатором async и изменить тип его возвращаемого значения на Task.
Помощь в написании контрольных, курсовых и дипломных работ здесь.
Смысл от выполнения async/await в синхронных методах
Привет всем! Текущая реализация фабрики не позволяет протянуть Task до вызывающего метода. Будет.
Как использовать async и await
Почему-то async и await не ни в какую не хотят работать. Ошибка CS1061 ‘Task » не.
Как правильно использовать async await
Здравствуйте! Есть программа, где вывод должен осуществляться при каждой итерации цикла, но этого.
Как использовать async/await в запросах SQL чтобы форма не зависала
Привет, когда нажимаю войти в авторизации то зависает форма, иногда до минуты надо ждать.
Как можно переписать этот метод на async/await?
как можно переписать этот метод на async/await const namesArr = ; function returnNull(err) <.
Как использовать оператор lock в статических методах
using System; using System.Collections.Generic; using System.Linq; using System.Text; using.
async/await (._. )
Опять я с глупым вопросом. Не могу понять, почему метод, который выгружает данные не асинхронный.
Aсинхронное программирование
Асинхронные методы, async и await
Асинхронность позволяет вынести отдельные задачи из основного потока в специальные асинхронные методы или блоки кода. Особенно это актуально в графических программах, где продолжительные задачи могу блокировать интерфейс пользователя. И чтобы этого не произошло, нужно задействовать асинхронность. Также асинхронность несет выгоды в веб-приложениях при обработке запросов от пользователей, при обращении к базам данных или сетевым ресурсам. При больших запросах к базе данных асинхронный метод просто уснет на время, пока не получит данные от БД, а основной поток сможет продолжить свою работу. В синхронном же приложении, если бы код получения данных находился в основном потоке, этот поток просто бы блокировался на время получения данных.
Асинхонный метод обладает следующими признаками:
В заголовке метода используется модификатор async
Метод содержит одно или несколько выражений await
В качестве возвращаемого типа используется один из следующих:
Рассмотрим пример асинхронного метода:
Выражение await определяет задачу, которая будет выполняться асинхронно. В данном случае подобная задача представляет выполнение функции факториала:
И в методе Main мы вызываем этот асинхронный метод.
Посмотрим, какой у программы будет консольный вывод:
Разберем поэтапно, что здесь происходит:
Запускается метод Main, в котором вызывается асинхронный метод FactorialAsync.
Метод FactorialAsync начинает выполняться синхронно вплоть до выражения await.
Выражение await запускает асинхронную задачу Task.Run(()=>Factorial())
Асинхронный метод ReadWriteAsync() выполняет запись в файл некоторой строки и затем считывает записанный файл. Подобные операции могут занимать продолжительное время, особенно при больших объемах данных, поэтому такие операции лучше делать асинхронными.
Далее в методе Main вызывается асинхронный метод ReadWriteAsync:
И опять же, когда выполнение в методе ReadWriteAsync доходит до первого выражения await, управление возвращается в метод Main, и мы можем продолжать с ним работу. Запись в файл и считывание файла будут производиться параллельно и не будут блокировать работу метода Main.
Определение асинхронной операции
Либо мы сами можем определить асинхронную операцию, используя метод Task.Run() :
Можно определить асинхронную операцию с помощью лямбда-выражения:
Передача параметров в асинхронную операцию
Выше вычислялся факториал 6, но, допустим, мы хотим вычислять факториалы разных чисел:
Получение результата из асинхронной операции
Асинхронная операция может возвращать некоторый результат, получить который мы можем так же, как и при вызове обычного метода:
Асинхронная модель программирования
Асинхронное программирование позволяет избежать появления узких мест производительности и увеличить общую скорость реагирования приложения. Однако традиционные методы создания асинхронных приложений могут оказаться сложными, как в плане написания кода, так и в плане отладки и обслуживания.
В этом разделе рассматриваются области и методы использования асинхронного программирования, а также приводятся ссылки на вспомогательные разделы с дополнительными сведениями и примерами.
Async повышает скорость реагирования
Асинхронность необходимо использовать при наличии потенциально блокирующих работу действий, например при осуществлении доступа к Интернету. Доступ к веб-ресурсу иногда осуществляется медленно или с задержкой. Если такое действие блокируется в синхронном процессе, все приложение вынуждено ожидать. В асинхронном процессе приложение может перейти к следующей операции, не зависящей от веб-ресурса, до завершения блокирующей задачи.
Асинхронность особенно полезна в приложениях, которые обращаются к потоку пользовательского интерфейса, поскольку все связанные с пользовательским интерфейсом действия обычно используют один поток. В синхронном приложении блокировка одного процесса приводит к блокировке всех процессов. Приложение перестает отвечать, и это выглядит как сбой, а не как ожидание.
При использовании асинхронных методов приложение продолжает реагировать на действия в пользовательском интерфейсе. Например, можно изменить размер окна или свернуть его, либо закрыть приложение, если не требуется ждать завершения работы.
Асинхронный подход добавляет эквивалент автоматической передачи в список параметров, выбранных при создании асинхронных операций. То есть разработчик может пользоваться всеми преимуществами традиционного асинхронного программирования, прикладывая гораздо меньше усилий.
Методы async проще создавать
Ниже приводится пример асинхронного метода. Почти все элементы кода должны быть вам знакомы.
Полный пример Windows Presentation Foundation (WPF), доступный для загрузки, см. в статье Асинхронное программирование с использованием ключевых слов async и await в C#.
Если метод GetUrlContentLengthAsync не выполняет никакие операции между вызовом метода GetStringAsync и его завершением, можно упростить код, описав вызов и ожидание с помощью следующего простого оператора.
Далее поясняется, почему код предыдущего примера является асинхронным методом:
Имя асинхронного метода, как правило, оканчивается суффиксом Async.
Возвращаемое значение имеет один из следующих типов:
В асинхронных методах с помощью соответствующих ключевых слов и типов указывается, что требуется сделать, а компилятор выполняет остальные задачи, в том числе отслеживает обязательные действия, когда управление возвращается в точку await в приостановленном методе. Некоторые программные процессы, такие как циклы и обработка исключений, сложно добавлять в традиционный асинхронный код. В асинхронном методе эти элементы пишутся почти так же, как в синхронном решении, что очень удобно.
Что происходит в методе Async
В асинхронном программировании важнее всего понимать, как поток управления перемещается из метода в метод. Следующая схема описывает этот процесс.
Числа на схеме соответствуют следующим шагам, которые запускаются, когда вызывающий метод вызывает асинхронный метод.
GetUrlContentLengthAsync создает экземпляр HttpClient и вызывает асинхронный метод GetStringAsync, чтобы загрузить содержимое веб-сайта в виде строки.
DoIndependentWork — это синхронный метод, который выполняет свой код и возвращает управление вызывающему объекту.
Если GetUrlContentLengthAsync содержит строковый результат, метод может вычислить длину строки. Затем работа GetUrlContentLengthAsync также завершена, и ожидающий обработчик событий может возобновить работу. В полном примере в конце этого раздела видно, что обработчик событий извлекает значение длины и выводит результат. Если вы недавно занимаетесь асинхронным программированием, рекомендуем обратить внимание на различия между синхронным и асинхронным поведением. Синхронный метод возвращает управление, когда его работа завершается (шаг 5), тогда как асинхронный метод возвращает значение задачи, когда его работа приостанавливается (шаги 3 и 6). Когда асинхронный метод в конечном счете завершает работу, задача помечается как завершенная и результат, при его наличии, сохраняется в задаче.
Async-методы API-интерфейсов
Среда выполнения Windows также содержит множество методов, которые можно использовать в сочетании с async и await в приложениях Windows. См. дополнительные сведения о потоковом и асинхронном программировании для разработки UWP, асинхронном программировании (приложения Магазина Windows), а также вызове асинхронных API в C# или Visual Basic, если вы используете предыдущие версии среды выполнения Windows.
Потоки
Асинхронные методы используются для неблокирующих операций. Выражение await в асинхронном методе не блокирует текущий поток на время выполнения ожидаемой задачи. Вместо этого выражение регистрирует остальную часть метода как продолжение и возвращает управление вызывающему объекту асинхронного метода.
Ключевые слова async и await не вызывают создания дополнительных потоков. Асинхронные методы не требуют многопоточности, поскольку асинхронный метод не выполняется в собственном потоке. Метод выполняется в текущем контексте синхронизации и использует время в потоке, только когда метод активен. Метод Task.Run можно применять для перемещения операций, использующих ресурсы ЦП, в фоновый поток, однако фоновый поток не имеет смысла применять для процесса, который просто ждет результата.
Асинхронный подход к асинхронному программированию практически по всем параметрам имеет преимущество перед другими подходами. В частности, такой подход эффективнее, чем использование класса BackgroundWorker для привязанных к вводу-выводу операций, так как используется более простой код и вам не нужно специально предотвращать состояние гонки. В сочетании с методом Task.Run асинхронное программирование лучше BackgroundWorker для операций, использующих ресурсы процессора, так как оно отделяет координацию выполнения кода от действий, которые Task.Run перемещает в пул потоков.
Async и Await
Если с помощью модификатора async указать, что метод является асинхронным, у вас появятся следующие две возможности.
Асинхронный метод сможет использовать await для обозначения точек приостановки. Оператор await сообщает компилятору, что асинхронный метод не может выполняться после этой точки до завершения ожидаемого асинхронного процесса. На это время управление возвращается вызывающему объекту асинхронного метода.
Приостановка асинхронного метода на выражении await не считается выходом из метода, и блоки finally не выполняются.
Сам обозначенный асинхронный метод может ожидаться вызывающими его методами.
async и await являются контекстными ключевыми словами. Дополнительные сведения и примеры см. в следующих разделах:
Типы и параметры возвращаемого значения
Используйте Task в качестве возвращаемого типа, если метод не содержит операторов return или содержит оператор return, который не возвращает операнд.
В следующем примере показано объявление и вызов метода, который возвращает Task или Task:
Каждая возвращенная задача представляет выполняющуюся работу. Задача инкапсулирует информацию о состоянии асинхронного процесса и, в итоге, либо конечный результат процесса, либо исключение, созданное процессом в случае его сбоя.
Асинхронный метод не может объявлять параметры in, ref или out, но может вызывать методы с этими параметрами. Аналогичным образом, асинхронный метод не может возвращать значение по ссылке, несмотря на то, что он может вызывать методы с возвращаемыми значениями ref.
Дополнительные сведения и примеры см. в статье Типы возвращаемых значений асинхронных операций (C#). Дополнительные сведения о перехвате исключений в асинхронных методах см. в описании механизма try-catch.
При программировании в среде выполнения Windows асинхронные API-интерфейсы имеют один из следующих возвращаемых типов, которые похожи на задачи.
Соглашение об именовании
Пошаговое руководство. Получение доступа к Интернету с помощью модификатора Async и оператора Await (Visual Basic)
Возможности Async и Await упрощают создание асинхронных программ. Можно написать асинхронный код, который выглядит как синхронный, и позволить компилятору обрабатывать трудные функции обратного вызова и продолжения, которые обычно включает асинхронный код.
Это пошаговое руководство начинается с создания синхронного приложения Windows Presentation Foundation (WPF), которое суммирует число байтов в списке веб-сайтов. Затем в рамках руководства приложение преобразуется в асинхронное решение с помощью новых возможностей.
В этом пошаговом руководстве выполняются следующие задачи.
Полный пример асинхронной работы см. в разделе » Пример «.
Предварительные требования
На компьютере должна быть установлена среда Visual Studio 2012 или более поздней версии. дополнительные сведения см. на странице загрузки Visual Studio.
Создание приложения WPF
Запустите Visual Studio.
В строке меню выберите Файл, Создать, Проект.
в области установленные шаблоны выберите Visual Basic, а затем выберите приложение WPF в списке типов проектов.
В текстовом поле Имя введите AsyncExampleWPF и нажмите кнопку ОК.
В обозревателе решений появится новый проект.
Разработка простого окна MainWindow WPF
Если окно панель элементов не отображается, откройте меню вид и выберите пункт панель элементов.
Добавьте элементы управления Button и TextBox в окно MainWindow.
Выделите элемент управления TextBox и в окне Свойства задайте указанные ниже значения.
Задайте для свойства Высота значение 250.
Задайте для свойства Ширина значение 500.
На вкладке Текст укажите моноширинный шрифт, например Lucida Console или Global Monospace.
Выделите элемент управления Button и в окне Свойства задайте указанные ниже значения.
Измените значение свойства Содержимое с Button на Start.
Поместите текстовое поле и кнопку так, чтобы оба элемента управления отображались в окне MainWindow.
Дополнительные сведения о конструкторе XAML WPF см. в разделе Создание пользовательского интерфейса с помощью конструктора XAML.
Добавление ссылки
В обозревателе решений выделите имя проекта.
В строке меню выберите Проект, Добавить ссылку.
Откроется диалоговое окно Диспетчер ссылок.
В области Сборки выберите Платформа, если этот вариант еще не выбран.
В списке имен установите флажок System.Net.Http.
Нажмите кнопку ОК, чтобы закрыть диалоговое окно.
Добавление необходимых операторов Imports
В Обозреватель решений откройте контекстное меню файла MainWindow. XAML. vb и выберите пункт Просмотреть код.
Добавьте следующие Imports инструкции в начало файла кода, если они еще не установлены.
Создание синхронного приложения
В файле MainWindow. XAML. vb скопируйте следующий код в текст startButton_Click :
Код для синхронного решения содержит следующие четыре метода:
Скопируйте следующие четыре метода и вставьте их в startButton_Click обработчик событий в MainWindow. XAML. vb:
Тестирование синхронного решения
Программа должна выдать результаты, похожие на следующий список:
Обратите внимание, что вывод результатов на экран занимает несколько секунд. В течение этого времени поток пользовательского интерфейса заблокирован, пока он ожидает загрузку запрошенных ресурсов. Соответственно, после нажатия кнопки Start окно нельзя перемещать, разворачивать, сворачивать или даже закрывать. Эти действия будут завершаться сбоем, пока не появятся результаты подсчета. Если веб-сайт не отвечает, вы не можете определить, на каком сайте произошел сбой. Трудно даже остановить ожидание и закрыть программу.
Преобразование GetURLContents в асинхронный метод
По мере выполнения шагов в этом пошаговом руководстве возникают различные ошибки компилятора. Их можно игнорировать и продолжить процедуры пошагового руководства.
Предыдущий оператор можно разделить на следующие два оператора для уточнения выполняемых операций.
Если асинхронный метод выполняет какие-то действия, это не зависит от выполнения задачи, метод может продолжать свои действия между выполнениями этих двух операторов: после вызова асинхронного метода и перед применением оператора await. примеры см. в разделе практическое руководство. параллельное выполнение нескольких веб-запросов с помощью инструкций async и Await (Visual Basic) и практическое руководство. расширение асинхронного пошагового руководства с помощью Task. WhenAll (Visual Basic).
Измените имя метода, вызывающего CopyToAsync.
Предыдущий оператор сокращает две следующие строки кода.
Метод GetURLContents имеет оператор return, который возвращает массив байтов. Таким образом, тип возвращаемого значения асинхронной версии — Task(T), где T — массив байтов. Внесите следующие изменения в подпись метода.
В следующем примере кода показаны эти изменения.
После внесения этих изменений преобразование GetURLContents в асинхронный метод завершено.
Преобразование SumPageSizes в асинхронный метод
В следующем примере кода показаны эти изменения.
Предыдущее назначение сокращает две следующие строки кода.
Внесите следующие изменения в подпись метода.
Добавьте в имя метода Async.
В следующем примере кода показаны эти изменения.
Преобразование SumPageSizes в SumPageSizesAsync завершено.
Преобразование startButton_Click в асинхронный метод
Поскольку SumPageSizesAsync является асинхронным методом, измените код в обработчике событий для ожидания результата.
Как и в предыдущих процедурах, вызов можно преобразовать, используя один или два оператора. В следующем примере кода показаны эти изменения.
Можно снова включить кнопку в конце обработчика событий.
Дополнительные сведения о повторном входе см. в статье обработка повторного входа в асинхронных приложениях (Visual Basic).
Как правило, имена обработчиков событий не изменяются. Тип возвращаемого значения не изменен на, Task так как обработчики событий должны быть Sub процедурами в Visual Basic.
Преобразование проекта из синхронного в асинхронный завершено.
Тестирование асинхронного решения
Появившиеся результаты должны напоминать результаты синхронного решения. Однако имеются следующие различия.
И что самое главное, поток пользовательского интерфейса не блокируется во время загрузки. Можно перемещать окно или изменять его размер во время загрузки, подсчета и отображения веб-ресурсов. Если один из веб-сайтов работает медленно или не отвечает, можно отменить операцию, нажав кнопку Закрыть (красный крестик в правом верхнем углу окна).
Первым шагом является создание HttpClient объекта в SumPageSizesAsync методе. Добавьте следующее объявление в начале метода.
Поведение этой версии проекта должно соответствовать поведению, которое описывается в процедуре «Тестирование асинхронного решения»; при этом с вашей стороны требуется даже меньше усилий.
Пример
Ниже приведен полный пример преобразованного асинхронного решения, использующего асинхронный GetURLContentsAsync метод. Обратите внимание, что он очень напоминает исходное синхронное решение.