DataTableReader.IsDBNull(Int32) Método

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém um valor que indica se a coluna contém valores inexistentes ou em falta.

public:
 override bool IsDBNull(int ordinal);
public override bool IsDBNull(int ordinal);
override this.IsDBNull : int -> bool
Public Overrides Function IsDBNull (ordinal As Integer) As Boolean

Parâmetros

ordinal
Int32

O ordinal da coluna baseada em zero.

Devoluções

Boolean

true se o valor da coluna especificado for equivalente a DBNull; caso contrário, false.

Exceções

ArgumentOutOfRangeException

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

DeletedRowInaccessibleException

Foi feita uma tentativa de recuperar dados de uma linha eliminada.

InvalidOperationException

Foi feita uma tentativa de ler ou aceder a uma coluna num arquivo fechado DataTableReader .

Exemplos

O exemplo seguinte mostra o conteúdo da coluna numerada 2 dentro do passado DataTableReader. Se o valor da coluna dentro de uma determinada linha for nulo, o código mostra o texto <NULL>. Se os dados dentro da coluna forem do tipo correto, o exemplo mostra 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.GetString(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.GetString(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

Observações

Chame este método para ver se existem valores nulos de coluna antes de chamar os métodos get tipados (por exemplo, GetByte, GetChar, e assim sucessivamente) para evitar gerar um erro.

Aplica-se a