DbDataReader.GetFieldValueAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

异步获取指定列的值作为请求的类型。

重载

GetFieldValueAsync<T>(Int32)	异步获取指定列的值作为请求的类型。
GetFieldValueAsync<T>(Int32, CancellationToken)	异步获取指定列的值作为请求的类型。

GetFieldValueAsync<T>(Int32)

Source:

DbDataReader.cs

异步获取指定列的值作为请求的类型。

public:
generic <typename T>
 System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal);

public System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal);

member this.GetFieldValueAsync : int -> System.Threading.Tasks.Task<'T>

Public Function GetFieldValueAsync(Of T) (ordinal As Integer) As Task(Of T)

类型参数

T

要返回的值的类型。

参数

ordinal

Int32

从零开始的列序号。

返回

Task<T>

Result 包含指定列的值的任务。

例外

InvalidOperationException

在数据检索期间删除或关闭连接。

- 或 -

在数据检索期间关闭数据读取器。

- 或 -

没有可读取的数据（例如尚未调用第一个 Read()，或调用返回了 false）。

- 或 -

按顺序模式尝试读取上一步骤中读取的列。

- 或 -

没有正在进行的异步操作。 以顺序模式运行时，这适用于所有 Get_*_ 方法，读取流时也可对其进行调用。

IndexOutOfRangeException

列索引超出范围。

InvalidCastException

数据库返回的值不匹配或不能转换为 T。

注解

仅当以顺序模式创建读取器时，才需要此异步方法以避免阻止调用线程。

如果未指定顺序模式，则每次 ReadAsync 完成时，所有列值都应在内存中可用，并且调用方法的同步版本不应阻止调用线程。

此异步方法的默认实现调用其同步对应方法并返回已完成的任务，这可能会阻止调用线程。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

当返回任务还未完成时， DbDataReader 对象的其他方法和属性不应调用 。

GetFieldValueAsync<T>(Int32, CancellationToken)

Source:

DbDataReader.cs

异步获取指定列的值作为请求的类型。

public:
generic <typename T>
 virtual System::Threading::Tasks::Task<T> ^ GetFieldValueAsync(int ordinal, System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<T> GetFieldValueAsync<T> (int ordinal, System.Threading.CancellationToken cancellationToken);

abstract member GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>
override this.GetFieldValueAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'T>

Public Overridable Function GetFieldValueAsync(Of T) (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of T)

类型参数

T

要返回的值的类型。

参数

ordinal

Int32

从零开始的列序号。

cancellationToken

CancellationToken

用于取消异步操作的令牌。

返回

Task<T>

Result 包含指定列的值的任务。

例外

InvalidOperationException

在数据检索期间删除或关闭连接。

- 或 -

在数据检索期间关闭数据读取器。

- 或 -

没有可读取的数据（例如尚未调用第一个 Read()，或调用返回了 false）。

- 或 -

按顺序模式尝试读取上一步骤中读取的列。

- 或 -

没有正在进行的异步操作。 以顺序模式运行时，这适用于所有 Get_*_ 方法，读取流时也可对其进行调用。

IndexOutOfRangeException

列索引超出范围。

InvalidCastException

数据库返回的值不匹配或不能转换为 T。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

仅当以顺序模式创建读取器时，才需要此异步方法以避免阻止调用线程。

如果未指定顺序模式，则每次 ReadAsync 完成时，所有列值都应在内存中可用，并且调用方法的同步版本不应阻止调用线程。

此异步方法的默认实现调用其同步对应方法并返回已完成的任务，这可能会阻止调用线程。 如果传递了已取消的取消令牌，则默认实现还会返回已取消的任务。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

该方法可用于请求操作之前接受取消标记。 实现可能会忽略该请求。

当返回任务还未完成时， DbDataReader 对象的其他方法和属性不应调用 。