EntityDataReader Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Odczytuje strumień wierszy tylko do przodu ze źródła danych.
public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecord
public class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecord
type EntityDataReader = class
inherit DbDataReader
interface IExtendedDataRecord
interface IDataRecord
Public Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord
- Dziedziczenie
- Implementuje
Uwagi
Łączy funkcje DbDataReader klasy i interfejsu IExtendedDataRecord .
Obiekt EntityDataReader nie ma publicznego konstruktora. Można go uzyskać tylko za pomocą jednego z EntityCommand.ExecuteReader
przeciążeń metody.
Program SQL Server umieszcza parametry wyjściowe z procedur składowanych na końcu strumienia wyników, po wszystkich zestawach wyników. W związku z tym, aby uzyskać wartości parametrów wyjściowych, aplikacja musi korzystać ze wszystkich rekordów we wszystkich zestawach wyników. Jeśli aplikacja zamknie EntityDataReader element (który również zamknie DbDataReaderparametr ), parametry wyjściowe mogą nie zostać wypełnione.
EntityDataReader nie używa niejawnie zestawów wyników, aby udostępnić parametry wyjściowe. W związku z tym należy zwrócić uwagę na następujące kwestie:
EntityDataReader wywołuje metodę DbDataReader.NextResult tylko wtedy, gdy EntityDataReader.NextResult jest jawnie wywoływana. Jeśli DbDataReader.NextResult zgłosi wyjątek, EntityDataReader obiekt zawija go w EntityException obiekcie (lub wyjątku pochodnego).
Close zamyka tylko element DbDataReader, bez używania żadnych oczekujących rekordów lub zestawów wyników.
Dispose usuwa tylko elementy DbDataReader, nie zużywając żadnych oczekujących rekordów ani zestawów wyników.
Przykłady kodu można znaleźć w temacie Working with EntityClient (Praca z elementem EntityClient).
Właściwości
DataRecordInfo |
Pobiera DataRecordInfo dla tego IExtendedDataRecordpliku . |
Depth |
Pobiera wartość wskazującą głębokość zagnieżdżania dla bieżącego wiersza. |
FieldCount |
Pobiera liczbę kolumn w bieżącym wierszu. |
HasRows |
Pobiera wartość wskazującą, czy zawiera on EntityDataReader co najmniej jeden wiersz. |
IsClosed |
Pobiera wartość wskazującą EntityDataReader , czy element jest zamknięty. |
Item[Int32] |
Pobiera wartość określonej kolumny jako wystąpienie klasy Object. |
Item[String] |
Pobiera wartość określonej kolumny jako wystąpienie klasy Object. |
RecordsAffected |
Pobiera liczbę wierszy zmienionych, wstawionych lub usuniętych przez wykonanie instrukcji SQL. |
VisibleFieldCount |
Pobiera liczbę pól w polach EntityDataReader , które nie są ukryte. |
Metody
Close() |
EntityDataReader Zamyka obiekt. |
CloseAsync() |
Asynchronicznie zamyka DbDataReader obiekt. (Odziedziczone po DbDataReader) |
CreateObjRef(Type) |
Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject) |
Dispose() |
Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader) |
Dispose(Boolean) |
Zwalnia zasoby używane przez tę funkcję EntityDataReader i wywołuje metodę Close(). |
DisposeAsync() |
Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie DbDataReader klasy. (Odziedziczone po DbDataReader) |
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetBoolean(Int32) |
Pobiera wartość określonej kolumny jako wartość logiczną. |
GetByte(Int32) |
Pobiera wartość określonej kolumny jako bajt. |
GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Odczytuje strumień bajtów z określonej kolumny, zaczynając od lokalizacji wskazanej przez |
GetChar(Int32) |
Pobiera wartość określonej kolumny jako pojedynczy znak. |
GetChars(Int32, Int64, Char[], Int32, Int32) |
Odczytuje strumień znaków z określonej kolumny, zaczynając od lokalizacji wskazanej przez |
GetColumnSchemaAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader).
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetData(Int32) |
Zwraca zagnieżdżony czytnik danych dla żądanej kolumny. (Odziedziczone po DbDataReader) |
GetDataReader(Int32) |
Zwraca zagnieżdżone czytniki jako DbDataReader obiekty. |
GetDataRecord(Int32) |
Zwraca zagnieżdżone DbDataRecordpolecenie . |
GetDataTypeName(Int32) |
Pobiera nazwę typu danych określonej kolumny. |
GetDateTime(Int32) |
Pobiera wartość określonej kolumny jako DateTime obiekt. |
GetDbDataReader(Int32) |
DbDataReader Zwraca obiekt dla żądanej kolumny porządkowej, który można zastąpić implementacją specyficzną dla dostawcy. |
GetDecimal(Int32) |
Pobiera wartość określonej kolumny jako Decimal obiekt. |
GetDouble(Int32) |
Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji. |
GetEnumerator() |
Zwraca wartość IEnumerator , która może służyć do iterowania wierszy w czytniku danych. |
GetFieldType(Int32) |
Pobiera typ danych określonej kolumny. |
GetFieldValue<T>(Int32) |
Pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader) |
GetFieldValueAsync<T>(Int32, CancellationToken) |
Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader) |
GetFieldValueAsync<T>(Int32) |
Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader) |
GetFloat(Int32) |
Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji. |
GetGuid(Int32) |
Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID). |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetInt16(Int32) |
Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem. |
GetInt32(Int32) |
Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem. |
GetInt64(Int32) |
Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem. |
GetLifetimeService() |
Przestarzałe.
Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
GetName(Int32) |
Pobiera nazwę kolumny, biorąc pod uwagę liczbę porządkową kolumny opartą na zera. |
GetOrdinal(String) |
Pobiera porządkową kolumnę o nazwie kolumny. |
GetProviderSpecificFieldType(Int32) |
Zwraca typ pola specyficznego dla dostawcy określonej kolumny. |
GetProviderSpecificValue(Int32) |
Pobiera wartość określonej kolumny jako wystąpienie klasy Object. |
GetProviderSpecificValues(Object[]) |
Pobiera wszystkie kolumny atrybutów specyficzne dla dostawcy w kolekcji dla bieżącego wiersza. |
GetSchemaTable() |
Zwraca obiekt DataTable , który opisuje metadane kolumny elementu DbDataReader. |
GetSchemaTableAsync(CancellationToken) |
Jest to asynchroniczna wersja programu GetSchemaTable().
Dostawcy powinni zastąpić odpowiednią implementacją.
Opcjonalnie |
GetStream(Int32) |
Pobiera strumień w celu pobrania danych z określonej kolumny. (Odziedziczone po DbDataReader) |
GetString(Int32) |
Pobiera wartość określonej kolumny jako wystąpienie klasy String. |
GetTextReader(Int32) |
Pobiera czytnik tekstu w celu pobrania danych z kolumny. (Odziedziczone po DbDataReader) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
GetValue(Int32) |
Pobiera wartość określonej kolumny jako wystąpienie klasy Object. |
GetValues(Object[]) |
Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza. |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject) |
IsDBNull(Int32) |
Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. |
IsDBNullAsync(Int32, CancellationToken) |
Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader) |
IsDBNullAsync(Int32) |
Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
MemberwiseClone(Boolean) |
Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject) |
NextResult() |
Rozwija czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. |
NextResultAsync() |
Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader) |
NextResultAsync(CancellationToken) |
Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader) |
Read() |
Umożliwia przejście czytnika do następnego rekordu w zestawie wyników. |
ReadAsync() |
Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader) |
ReadAsync(CancellationToken) |
Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
IDataRecord.GetData(Int32) |
Aby uzyskać opis tego członka, zobacz GetData(Int32). (Odziedziczone po DbDataReader) |
Metody rozszerzania
CanGetColumnSchema(DbDataReader) |
Pobiera wartość wskazującą, czy DbDataReader można uzyskać schemat kolumny. |
GetColumnSchema(DbDataReader) |
Pobiera schemat kolumny (DbColumn kolekcja) dla elementu DbDataReader. |
Cast<TResult>(IEnumerable) |
Rzutuje elementy obiektu IEnumerable na określony typ. |
OfType<TResult>(IEnumerable) |
Filtruje elementy IEnumerable elementu na podstawie określonego typu. |
AsParallel(IEnumerable) |
Umożliwia równoległość zapytania. |
AsQueryable(IEnumerable) |
Konwertuje element IEnumerable na .IQueryable |