DbDataReader.IsDBNullAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.
Overloads
| Name | Description |
|---|---|
| IsDBNullAsync(Int32) |
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. |
| IsDBNullAsync(Int32, CancellationToken) |
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. |
IsDBNullAsync(Int32)
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.
public:
System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal);public System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal);member this.IsDBNullAsync : int -> System.Threading.Tasks.Task<bool>Public Function IsDBNullAsync (ordinal As Integer) As Task(Of Boolean)Parameters
- ordinal
- Int32
De kolom op basis van nul die moet worden opgehaald.
Retouren
Een Task<TResult> waarvan Result de eigenschap is true als de opgegeven kolomwaarde gelijk is aan DBNull of false niet.
Uitzonderingen
De verbinding is verbroken of gesloten tijdens het ophalen van gegevens.
– of –
De gegevenslezer wordt gesloten tijdens het ophalen van gegevens.
– of –
Er zijn geen gegevens die kunnen worden gelezen (de eerste Read() is bijvoorbeeld niet aangeroepen of retourneert onwaar).
– of –
Een eerder gelezen kolom in de sequentiële modus proberen te lezen.
– of –
Er is een asynchrone bewerking uitgevoerd. Dit geldt voor alle Get*-methoden bij het uitvoeren in de sequentiële modus, omdat ze kunnen worden aangeroepen tijdens het lezen van een stream.
De kolomindex valt buiten het bereik.
Opmerkingen
Deze asynchrone methode is alleen nodig om te voorkomen dat de aanroepende thread wordt geblokkeerd wanneer de lezer in de sequentiële modus wordt gemaakt.
Als de sequentiële modus niet is opgegeven, moeten alle kolomwaarden beschikbaar komen in het geheugen telkens wanneer ReadAsync is voltooid en moet het aanroepen van de synchrone versie van de methode de aanroepende thread niet blokkeren.
De standaardimplementatie van deze asynchrone methode roept de synchrone tegenhanger aan en retourneert een voltooide taak, waardoor de aanroepende thread mogelijk wordt geblokkeerd.
Gegevensproviders die asynchrone programmering ondersteunen, moeten de standaard implementatie overschrijven met behulp van asynchrone I/O-bewerkingen.
Andere methoden en eigenschappen van het DbDataReader-object mogen niet worden aangeroepen terwijl de geretourneerde taak nog niet is voltooid.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door IsDBNull(Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
IsDBNullAsync(Int32, CancellationToken)
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat.
public:
virtual System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal, System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal, System.Threading.CancellationToken cancellationToken);abstract member IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- ordinal
- Int32
De kolom op basis van nul die moet worden opgehaald.
- cancellationToken
- CancellationToken
Een token om de asynchrone bewerking te annuleren.
Retouren
Een Task<TResult> waarvan Result de eigenschap is true als de opgegeven kolomwaarde gelijk is aan DBNull of false niet.
Uitzonderingen
De verbinding is verbroken of gesloten tijdens het ophalen van gegevens.
– of –
De gegevenslezer wordt gesloten tijdens het ophalen van gegevens.
– of –
Er zijn geen gegevens die kunnen worden gelezen (de eerste Read() is bijvoorbeeld niet aangeroepen of retourneert onwaar).
– of –
Een eerder gelezen kolom in de sequentiële modus proberen te lezen.
– of –
Er is een asynchrone bewerking uitgevoerd. Dit geldt voor alle Get*-methoden bij het uitvoeren in de sequentiële modus, omdat ze kunnen worden aangeroepen tijdens het lezen van een stream.
De kolomindex valt buiten het bereik.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Deze asynchrone methode is alleen nodig om te voorkomen dat de aanroepende thread wordt geblokkeerd wanneer de lezer in de sequentiële modus wordt gemaakt.
Als de sequentiële modus niet is opgegeven, moeten alle kolomwaarden beschikbaar komen in het geheugen telkens wanneer ReadAsync is voltooid en moet het aanroepen van de synchrone versie van de methode de aanroepende thread niet blokkeren.
De standaardimplementatie van deze asynchrone methode roept de synchrone tegenhanger aan en retourneert een voltooide taak, waardoor de aanroepende thread mogelijk wordt geblokkeerd. De standaardimplementatie retourneert ook een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven.
Gegevensproviders die asynchrone programmering ondersteunen, moeten de standaard implementatie overschrijven met behulp van asynchrone I/O-bewerkingen.
Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren.
Andere methoden en eigenschappen van het DbDataReader-object mogen niet worden aangeroepen terwijl de geretourneerde taak nog niet is voltooid. Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door IsDBNull(Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.