DataTableReader.GetByte(Int32) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataTableReader.cs

Obtém o valor da coluna especificada como um byte.

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

Parâmetros

ordinal

Int32

O ordinal da coluna baseado em zero.

Retornos

Byte

O valor da coluna especificada.

Exceções

ArgumentOutOfRangeException

O índice passado estava fora do intervalo de 0 a FieldCount -1.

DeletedRowInaccessibleException

Foi feita uma tentativa de recuperar dados de uma linha excluída.

InvalidOperationException

Foi feita uma tentativa de ler ou acessar uma coluna em um DataTableReader fechado.

InvalidCastException

A coluna especificada não contém um byte.

Exemplos

O exemplo a seguir exibe o conteúdo da coluna numerada 2 dentro do passado DataTableReader. Se o valor da coluna dentro de uma linha específica for nulo, o código exibirá o texto <NULL>. Se os dados dentro da coluna não forem do tipo correto, o exemplo exibirá uma mensagem de erro para cada linha.

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

Comentários

Nenhuma conversão é executada; portanto, os dados recuperados já devem ser um byte ou coercível para um byte.

Chame IsDBNull para ver se há valores nulos antes de chamar esse método.