DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) DataTableReader.GetValue(Int32) Method

Определение

Возвращает значение заданного столбца в его исходном формате.Gets the value of the specified column in its native format.

public:
 override System::Object ^ GetValue(int ordinal);
public override object GetValue (int ordinal);
override this.GetValue : int -> obj
Public Overrides Function GetValue (ordinal As Integer) As Object

Параметры

ordinal
Int32 Int32 Int32 Int32

Порядковый номер (с нуля) столбца.The zero-based column ordinal

Возвраты

Значение указанного столбца.The value of the specified column. Этот метод возвращает значение с типом DBNull для столбцов со значениями null.This method returns DBNull for null columns.

Исключения

Переданный индекс находился вне диапазона от 0 до FieldCount - 1.The index passed was outside the range of 0 to FieldCount - 1.

Предпринята попытка извлечения данных из удаленной строки.An attempt was made to retrieve data from a deleted row.

Предпринята попытка чтения столбцов закрытого объекта DataTableReader или получения доступа к ним.An attempt was made to read or access columns in a closed DataTableReader .

Примеры

В следующем примере выполняется перебор всех столбцов в текущей строке в DataTableReader, отображая содержимое каждого столбца и имя столбца.The following example iterates through all the columns within the current row in a DataTableReader, displaying the contents of each column and the column name. Как правило, если предполагается работать со всеми столбцами в строке DataTableReader, полученной с помощью, рекомендуется GetValues использовать вместо этого метод, так как он более эффективен.Generally, if your intent is to work with all the columns within a row retrieved by a DataTableReader, consider using the GetValues method instead, because it is more efficient.

private static void GetAllValues(DataTableReader reader)
{
    // Given a DataTableReader, retrieve the value of 
    // each column, and display the name, value, and type.
    // Make sure you have called reader.Read at least once before
    // calling this procedure.

    // Loop through all the columns.
    object value = null;
    for (int i = 0; i < reader.FieldCount; i++)
    {
        if (reader.IsDBNull(i))
        {
            value = "<NULL>";
        }
        else
        {
            value = reader.GetValue(i);
        }
        Console.WriteLine("{0}: {1} ({2})", reader.GetName(i), 
            value, reader.GetFieldType(i).Name);
    }
}
Private Sub GetAllValues(ByVal reader As DataTableReader)

   ' Given a DataTableReader, retrieve the value of 
   ' each column, and display the name, value, and type.
   ' Make sure you've called reader.Read at least once before
   ' calling this procedure.
   ' Loop through all the columns.
   Dim value As Object
   For i As Integer = 0 To reader.FieldCount - 1
      If reader.IsDBNull(i) Then
         value = "<NULL>"
      Else
         value = reader.GetValue(i)
      End If
      Console.WriteLine("{0}: {1} ({2})", reader.GetName(i), _
         value, reader.GetFieldType(i).Name)
   Next
End Sub

Комментарии

Хотя можно вызвать IsDBNull , чтобы проверить наличие значений null перед вызовом этого метода, нет необходимости делать это.Although you can call IsDBNull to see if there are null values before calling this method, you do not have to do this.

Применяется к