DbCommand.ExecuteNonQueryAsync Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Tato metoda implementuje asynchronní verzi , ExecuteNonQuery()ale vrací Task synchronně a blokuje volající vlákno.

Přetížení

ExecuteNonQueryAsync(CancellationToken)

Toto je asynchronní verze nástroje ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení se může volitelně ignorovat. Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud vrácená úloha není dokončena.

ExecuteNonQueryAsync()

Asynchronní verze nástroje ExecuteNonQuery(), která spustí příkaz proti objektu připojení a vrátí počet ovlivněných řádků. ExecuteNonQueryAsync(CancellationToken) Vyvolá s CancellationToken.None.

Poznámky

Další informace o asynchronním programování naleznete v tématu Asynchronní programování.

ExecuteNonQueryAsync(CancellationToken)

Zdroj:

DbCommand.cs

Toto je asynchronní verze nástroje ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení se může volitelně ignorovat.

Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu).

Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud vrácená úloha není dokončena.

public:
 virtual System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken);

abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)

Parametry

cancellationToken

CancellationToken

Token pro zrušení asynchronní operace.

Návraty

Task<Int32>

Úloha představující asynchronní operaci

Výjimky

DbException

Při provádění příkazu došlo k chybě.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Další informace o asynchronním programování naleznete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteNonQuery().

Viz také

• Přehled ADO.NET

ExecuteNonQueryAsync()

Zdroj:

DbCommand.cs

Asynchronní verze nástroje ExecuteNonQuery(), která spustí příkaz proti objektu připojení a vrátí počet ovlivněných řádků.

ExecuteNonQueryAsync(CancellationToken) Vyvolá s CancellationToken.None.

public:
 System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();

public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync ();

member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>

Public Function ExecuteNonQueryAsync () As Task(Of Integer)

Návraty

Task<Int32>

Úloha představující asynchronní operaci

Výjimky

DbException

Při provádění příkazu došlo k chybě.

Poznámky

Další informace o asynchronním programování naleznete v tématu Asynchronní programování.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem ExecuteNonQuery().

Viz také

• Přehled ADO.NET