Класс SqlCeDataReader

  • Статья

Указывает способ считывания потока строк данных из источника данных с возможностью перемещения только вперед. Этот класс не может быть унаследован.

Иерархия наследования

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

Пространство имен:  System.Data.SqlServerCe
Сборка:  System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
Public Class SqlCeDataReader _
    Inherits DbDataReader
'Применение
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

Тип SqlCeDataReader обеспечивает доступ к следующим элементам.

Свойства

  Имя Описание
Открытое свойство Depth Возвращает значение, показывающее глубину вложенности для текущей строки. (Переопределяет DbDataReader.Depth.)
Открытое свойство FieldCount Возвращает число столбцов в предложении SELECT запроса. (Переопределяет DbDataReader.FieldCount.)
Открытое свойство HasRows Возвращает значение, указывающее на то, что в модуле чтения данных SqlCeDataReader содержится одна или несколько строк. (Переопределяет DbDataReader.HasRows.)
Открытое свойство HiddenFieldCount Инфраструктура.
Открытое свойство IsClosed Показывает, закрыт ли модуль чтения данных. (Переопределяет DbDataReader.IsClosed.)
Открытое свойство Item[Int32] Возвращает значение указанного столбца по порядковому номеру в его собственном формате. (Переопределяет DbDataReader.Item[Int32].)
Открытое свойство Item[String] Возвращает значение указанного столбца по имени в его собственном формате. (Переопределяет DbDataReader.Item[String].)
Открытое свойство RecordsAffected Возвращает число строк, которые были изменены, вставлены или удалены инструкцией SQL. (Переопределяет DbDataReader.RecordsAffected.)
Открытое свойство VisibleFieldCount (унаследовано из DbDataReader)

В начало

Методы

  Имя Описание
Открытый метод Close Закрывает объект SqlCeDataReader. (Переопределяет DbDataReader.Close().)
Открытый метод CreateObjRef (унаследовано из MarshalByRefObject)
Открытый метод Dispose() Инфраструктура. Освобождает ресурсы, используемые данным модулем чтения данных SqlCeDataReader.
Защищенный метод Dispose(Boolean) Освобождает неуправляемые ресурсы, используемые классом SqlCeDataReader, и при необходимости освобождает управляемые ресурсы. (Переопределяет DbDataReader.Dispose(Boolean).)
Открытый метод Equals (унаследовано из Object)
Защищенный метод Finalize Освобождает неуправляемые ресурсы и выполняет другие операции очистки перед обработкой модуля чтения данных SqlCeDataReader сборщиком мусора. (Переопределяет Object.Finalize().)
Открытый метод GetBoolean Возвращает значение указанного столбца в виде логического значения. (Переопределяет DbDataReader.GetBoolean(Int32).)
Открытый метод GetByte Возвращает значение указанного столбца в виде байта. (Переопределяет DbDataReader.GetByte(Int32).)
Открытый метод GetBytes Считывает поток байтов с указанного смещения столбца в буфер в виде массива, начинающегося с заданного смещения. (Переопределяет DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
Открытый метод GetChar Не поддерживается поставщиком данных .NET Compact Framework для SQL Server Compact. (Переопределяет DbDataReader.GetChar(Int32).)
Открытый метод GetChars Считывает поток символов с указанного смещения столбца в буфер в виде массива, начиная с заданного смещения. (Переопределяет DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
Открытый метод GetData (унаследовано из DbDataReader)
Открытый метод GetDataTypeName Получает имя исходного типа данных. (Переопределяет DbDataReader.GetDataTypeName(Int32).)
Открытый метод GetDateTime Возвращает значение указанного столбца в виде объекта DateTime. (Переопределяет DbDataReader.GetDateTime(Int32).)
Защищенный метод GetDbDataReader (унаследовано из DbDataReader)
Открытый метод GetDecimal Возвращает значение указанного столбца в виде объекта Decimal. (Переопределяет DbDataReader.GetDecimal(Int32).)
Открытый метод GetDouble Возвращает значение заданного столбца в виде числа с плавающей запятой двойной точности. (Переопределяет DbDataReader.GetDouble(Int32).)
Открытый метод GetEnumerator Инфраструктура. (Переопределяет DbDataReader.GetEnumerator().)
Открытый метод GetFieldType Возвращает значение Type, которое представляет тип данных объекта. (Переопределяет DbDataReader.GetFieldType(Int32).)
Открытый метод GetFloat Возвращает значение заданного столбца в виде числа с плавающей запятой одиночной точности. (Переопределяет DbDataReader.GetFloat(Int32).)
Открытый метод GetGuid Возвращает значение заданного столбца в виде идентификатора GUID. (Переопределяет DbDataReader.GetGuid(Int32).)
Открытый метод GetHashCode (унаследовано из Object)
Открытый метод GetInt16 Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком. (Переопределяет DbDataReader.GetInt16(Int32).)
Открытый метод GetInt32 Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком. (Переопределяет DbDataReader.GetInt32(Int32).)
Открытый метод GetInt64 Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком. (Переопределяет DbDataReader.GetInt64(Int32).)
Открытый метод GetLifetimeService (унаследовано из MarshalByRefObject)
Открытый метод GetName Возвращает имя заданного столбца. (Переопределяет DbDataReader.GetName(Int32).)
Открытый метод GetOrdinal Возвращает порядковый номер столбца, если известно его имя. (Переопределяет DbDataReader.GetOrdinal(String).)
Открытый метод GetProviderSpecificFieldType Возвращает объект Object, который представляет базовый тип поля, специфичный для поставщика. (Переопределяет DbDataReader.GetProviderSpecificFieldType(Int32).)
Открытый метод GetProviderSpecificValue (унаследовано из DbDataReader)
Открытый метод GetProviderSpecificValues (унаследовано из DbDataReader)
Открытый метод GetSchemaTable Возвращает объект DataTable, описывающий метаданные столбцов модуля чтения данных SqlCeDataReader. (Переопределяет DbDataReader.GetSchemaTable().)
Открытый метод GetSqlBinary Возвращает значение указанного столбца как SqlBinary.
Открытый метод GetSqlBoolean Возвращает значение указанного столбца как SqlBoolean.
Открытый метод GetSqlByte Возвращает значение указанного столбца как SqlByte.
Открытый метод GetSqlDateTime Возвращает значение указанного столбца как SqlDateTime.
Открытый метод GetSqlDecimal Возвращает значение указанного столбца как SqlDecimal.
Открытый метод GetSqlDouble Возвращает значение указанного столбца как SqlDouble.
Открытый метод GetSqlGuid Возвращает значение указанного столбца как SqlGuid.
Открытый метод GetSqlInt16 Возвращает значение указанного столбца как SqlInt16.
Открытый метод GetSqlInt32 Возвращает значение указанного столбца как SqlInt32.
Открытый метод GetSqlInt64 Возвращает значение указанного столбца как SqlInt64.
Открытый метод GetSqlMoney Возвращает значение указанного столбца как SqlMoney.
Открытый метод GetSqlSingle Возвращает значение указанного столбца как SqlSingle.
Открытый метод GetSqlString Возвращает значение указанного столбца как SqlString.
Открытый метод GetString Возвращает значение указанного столбца в виде строки. (Переопределяет DbDataReader.GetString(Int32).)
Открытый метод GetType (унаследовано из Object)
Открытый метод GetValue Возвращает значение столбца по указанному порядковому номеру в его собственном формате. (Переопределяет DbDataReader.GetValue(Int32).)
Открытый метод GetValues Возвращает все столбцы атрибутов в текущей строке. (Переопределяет DbDataReader.GetValues(array<Object[]).)
Открытый метод InitializeLifetimeService (унаследовано из MarshalByRefObject)
Защищенный метод IsCommandBehavior Определяет, совпадает ли объект CommandBehavior с поведением объекта SqlCeDataReader.
Открытый метод IsDBNull Возвращает значение, указывающее, содержатся ли в столбце несуществующие или отсутствующие значения. (Переопределяет DbDataReader.IsDBNull(Int32).)
Защищенный метод MemberwiseClone() (унаследовано из Object)
Защищенный метод MemberwiseClone(Boolean) (унаследовано из MarshalByRefObject)
Открытый метод NextResult Не поддерживается поставщиком данных .NET Compact Framework для SQL Server Compact. (Переопределяет DbDataReader.NextResult().)
Защищенный метод OnMove Инфраструктура.
Открытый метод Read Перемещает модуль чтения данных SqlCeDataReader к следующей записи. (Переопределяет DbDataReader.Read().)
Открытый метод Seek Позиционирует модуль чтения данных SqlCeDataReader на запись со значениями индекса, совпадающими с заданными параметрами.
Открытый метод ToString (унаследовано из Object)

В начало

Явные реализации интерфейса

  Имя Описание
Явная реализация интерфейсаЗакрытый метод IDataRecord.GetData (унаследовано из DbDataReader)

В начало

Замечания

Создание модуля чтения данных SqlCeDataReader необходимо производить не прямым использованием конструктора, а вызовом метода ExecuteReader объекта SqlCeCommand.

Если SqlCeDataReader занят, то связанное соединение SqlCeConnection занято обслуживанием SqlCeDataReader. В этом состоянии в одном и том же соединении может быть создано несколько модулей чтения.

Изменения, которые были сделаны в результирующем наборе другим процессом или потоком во время считывания данных, с некоторой вероятностью могут быть видны пользователю модуля чтения данных SqlCeDataReader, хотя это зависит от того, когда именно эти изменения произошли.

IsClosed и RecordsAffected являются единственными свойствами, к которым могут производиться обращения после закрытия SqlCeDataReader. Хотя к свойству RecordsAffected можно обращаться в любое время, пока существует модуль чтения данных SqlCeDataReader, рекомендуется всегда вызывать метод Close перед получением значения свойства RecordsAffected, чтобы гарантировать точность возвращаемых значений.

Примеры

Следующий пример демонстрирует создание SqlCeConnection, SqlCeCommand и SqlCeDataReader. В примере данные сначала считываются, а затем выводятся на консоль. После этого закрываются модуль чтения данных SqlCeDataReader и соединение SqlCeConnection.

Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Open the connection and create a SQL command
    '
    conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
    conn.Open()

    cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)

    rdr = cmd.ExecuteReader()

    ' Iterate through the results
    '
    While rdr.Read()
        Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
        Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
    End While

    ' Always dispose data readers and commands as soon as practicable
    '
    rdr.Close()
    cmd.Dispose()
Finally
    ' Close the connection when no longer needed
    '
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;

try
{
    // Open the connection and create a SQL command
    //
    conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
    conn.Open();

    cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);

    rdr = cmd.ExecuteReader();

    // Iterate through the results
    //
    while (rdr.Read())
    {
        int employeeID = rdr.GetInt32(0);   // or: rdr["EmployeeKey"];
        string lastName = rdr.GetString(5); // or: rdr["FirstName"];
    }

    // Always dispose data readers and commands as soon as practicable
    //
    rdr.Close();
    cmd.Dispose();
}
finally
{
    // Close the connection when no longer needed
    //
    conn.Close();
}

Безопасность многопоточности

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Пространство имен System.Data.SqlServerCe