DbConnection.OpenAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Tato metoda implementuje asynchronní verzi nástroje Open().
Přetížení
OpenAsync() |
Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným ConnectionStringnástrojem . Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) s CancellationToken.None. |
OpenAsync(CancellationToken) |
Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušený úkol, pokud již zrušený cancellationToken. Výjimky vyvolané otevřením budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. Nevyvolávej jiné metody a vlastnosti objektu |
Poznámky
Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.
OpenAsync()
- Zdroj:
- DbConnection.cs
- Zdroj:
- DbConnection.cs
- Zdroj:
- DbConnection.cs
Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným ConnectionStringnástrojem . Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) s CancellationToken.None.
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
Návraty
Úloha představující asynchronní operaci
Poznámky
Po volání OpenAsyncState se musí vrátitConnecting, dokud se vrácené Task volání nedokonči. Pokud bylo připojení úspěšné, State musí vrátit Open. Pokud připojení selže, State musí vrátit Closed.
Volání se Close pokusí zrušit nebo zavřít odpovídající OpenAsync hovor.
Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Open().
Viz také
Platí pro
OpenAsync(CancellationToken)
- Zdroj:
- DbConnection.cs
- Zdroj:
- DbConnection.cs
- Zdroj:
- DbConnection.cs
Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat.
Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušený úkol, pokud již zrušený cancellationToken. Výjimky vyvolané otevřením budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu.
Nevyvolávej jiné metody a vlastnosti objektu DbConnection
, dokud nebude dokončena vrácená úloha.
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
Parametry
- cancellationToken
- CancellationToken
Instrukce zrušení
Návraty
Úloha představující asynchronní operaci
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Po volání OpenAsyncState se musí vrátitConnecting, dokud se vrácené Task volání nedokonči. Pokud bylo připojení úspěšné, State musí vrátit Open. Pokud připojení selže, State musí vrátit Closed.
Volání se Close pokusí zrušit nebo zavřít odpovídající OpenAsync hovor.
Další informace o asynchronním programování v zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Open().