DataTableReader.GetByte(Int32) 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

Source:

DataTableReader.cs

以字节的形式获取指定列的值。

public:
 override System::Byte GetByte(int ordinal);

public override byte GetByte (int ordinal);

override this.GetByte : int -> byte

Public Overrides Function GetByte (ordinal As Integer) As Byte

参数

ordinal

Int32

从零开始的列序号。

返回

Byte

指定列的值。

例外

ArgumentOutOfRangeException

传递的索引超出了 0 到 FieldCount -1 的范围。

DeletedRowInaccessibleException

尝试从已删除的行中检索数据。

InvalidOperationException

尝试读取或访问已关闭的 DataTableReader 中的列。

InvalidCastException

指定的列不包含字节。

示例

以下示例显示传入 DataTableReader的 中编号为 2 的列的内容。 如果特定行中的列的值为 null，则代码将显示文本 <NULL>。 如果列中的数据类型不正确，则本示例为每行显示一条错误消息。

private static void PrintColumn(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        if (reader.IsDBNull(2))
        {
            Console.Write("<NULL>");
        }
        else
        {
            try
            {
                Console.Write(reader.GetByte(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}

Private Sub PrintColumn(ByVal reader As DataTableReader)
   ' Loop through all the rows in the DataTableReader
   While reader.Read()
      If reader.IsDBNull(2) Then
         Console.Write("<NULL>")
      Else
         Try
            Console.Write(reader.GetByte(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

注解

不执行任何转换;因此，检索到的数据必须已是字节或可强制转换为字节。

调用 IsDBNull 以查看在调用此方法之前是否存在 null 值。