DbConnection.OpenAsync Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Ez a metódus aszinkron verzióját Open()implementálja.

Túlterhelések

Name	Description
OpenAsync()	A /> aszinkron verziója, amely adatbázis-kapcsolatot nyit meg a megadott beállításokkal. Ez a metódus meghívja a virtuális metódust OpenAsync(CancellationToken) a CancellationToken.None használatával.
OpenAsync(CancellationToken)	Ez aszinkron verziója.Open() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat tetszés szerint tiszteletben tartható. Az alapértelmezett implementáció meghívja a szinkron Open() hívást, és egy befejezett feladatot ad vissza. Az alapértelmezett implementáció egy megszakított feladatot ad vissza, ha egy már törölt cancellationTokent adott át. A Megnyitás által okozott kivételeket a rendszer a visszaadott Tevékenységkivétel tulajdonságon keresztül közli. Ne hívja meg az DbConnection objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik.

Megjegyzések

Az aszinkron programozásról a .NET Keretrendszer Data Provider SQL Server című témakörben talál további információt: Aszinkron programozás.

OpenAsync()

Forrás:

DbConnection.cs

A /> aszinkron verziója, amely adatbázis-kapcsolatot nyit meg a megadott beállításokkal. Ez a metódus meghívja a virtuális metódust OpenAsync(CancellationToken) a CancellationToken.None használatával.

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

Válaszok

Task

Az aszinkron műveletet képviselő feladat.

Megjegyzések

A hívás OpenAsyncState után vissza kell térnieConnecting, amíg a visszaadott Task érték be nem fejeződik. Ezután, ha a kapcsolat sikeres volt, State vissza kell térnie Open. Ha a kapcsolat meghiúsul, State vissza kell térnie Closed.

A hívás megkísérli Close megszakítani vagy bezárni a megfelelő OpenAsync hívást.

Az aszinkron programozásról a .NET Keretrendszer Data Provider SQL Server című témakörben talál további információt: Aszinkron programozás.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Open()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése

OpenAsync(CancellationToken)

Forrás:

DbConnection.cs

Ez aszinkron verziója.Open() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. A lemondási jogkivonat tetszés szerint tiszteletben tartható.

Az alapértelmezett implementáció meghívja a szinkron Open() hívást, és egy befejezett feladatot ad vissza. Az alapértelmezett implementáció egy megszakított feladatot ad vissza, ha egy már törölt cancellationTokent adott át. A Megnyitás által okozott kivételeket a rendszer a visszaadott Tevékenységkivétel tulajdonságon keresztül közli.

Ne hívja meg az DbConnection objektum egyéb metódusait és tulajdonságait, amíg a visszaadott feladat be nem fejeződik.

public:
 virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);

abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Paraméterek

cancellationToken

CancellationToken

A lemondási utasítás.

Válaszok

Task

Az aszinkron műveletet képviselő feladat.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

A hívás OpenAsyncState után vissza kell térnieConnecting, amíg a visszaadott Task érték be nem fejeződik. Ezután, ha a kapcsolat sikeres volt, State vissza kell térnie Open. Ha a kapcsolat meghiúsul, State vissza kell térnie Closed.

A hívás megkísérli Close megszakítani vagy bezárni a megfelelő OpenAsync hívást.

Az aszinkron programozásról a .NET Keretrendszer Data Provider SQL Server című témakörben talál további információt: Aszinkron programozás.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Open()kiadott kivételeket: .

Lásd még

• ADO.NET áttekintése