EntityDataReader Classe

Référence

Définition

Espace de noms:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit un flux avant uniquement de lignes d'une source de données.

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

Héritage: Object

MarshalByRefObject

DbDataReader
EntityDataReader

Implémente: IDataRecord IExtendedDataRecord

Remarques

Combine les fonctionnalités de la classe DbDataReader et de l'interface IExtendedDataRecord.

EntityDataReader n'a pas de constructeur public. Il ne peut être obtenu que par l’une EntityCommand.ExecuteReader des surcharges de méthode.

SQL Server place les paramètres de sortie des procédures stockées à la fin du flux de résultats, après tous les jeux de résultats. Par conséquent, pour obtenir les valeurs de paramètres de sortie, une application doit lire les enregistrements dans tous les jeux de résultats. Si l'application ferme EntityDataReader (ce qui entraîne également la fermeture de DbDataReader), les paramètres de sortie ne peuvent pas être remplis.

EntityDataReader ne lit pas les jeux de résultats de manière implicite pour rendre les paramètres de sortie disponibles. Par conséquent, notez les points suivants :

EntityDataReader appelle la méthode DbDataReader.NextResult uniquement lorsque la méthode EntityDataReader.NextResult est explicitement appelée. Si DbDataReader.NextResult lève une exception, le EntityDataReader est encapsulé dans une EntityException (ou une exception dérivée).
La méthode Close ferme simplement DbDataReader, sans lire les enregistrements ou les jeux de résultats en attente.
Dispose supprime simplement DbDataReader, sans lire les enregistrements ou les jeux de résultats en attente.

Pour obtenir des exemples de code, consultez Utilisation d’EntityClient.

Propriétés

DataRecordInfo	Obtient DataRecordInfo pour IExtendedDataRecord.
Depth	Obtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle.
FieldCount	Obtient le nombre de colonnes figurant dans la ligne actuelle.
HasRows	Obtient une valeur qui indique si cet objet EntityDataReader contient une ou plusieurs lignes.
IsClosed	Obtient une valeur indiquant si l'objet EntityDataReader est fermé.
Item[Int32]	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet Object.
Item[String]	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet Object.
RecordsAffected	Obtient le nombre de lignes modifiées, insérées ou supprimées par l'exécution de l'instruction SQL.
VisibleFieldCount	Obtient le nombre de champs dans EntityDataReader qui ne sont pas masqués.

Méthodes

Close()	Ferme l'objet EntityDataReader.
CloseAsync()	Ferme de façon asynchrone l’objet DbDataReader. (Hérité de DbDataReader)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe DbDataReader. (Hérité de DbDataReader)
Dispose(Boolean)	Libère les ressources utilisées par cet objet EntityDataReader et appelle Close().
DisposeAsync()	Libère de façon asynchrone toutes les ressources utilisées par l’instance actuelle de la classe DbDataReader. (Hérité de DbDataReader)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBoolean(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'une valeur Boolean.
GetByte(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un octet.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lit un flux de données d'octets de la colonne spécifiée, en commençant à l'emplacement indiqué par `dataIndex`, dans la mémoire tampon, en commençant à l'emplacement indiqué par `bufferIndex`.
GetChar(Int32)	Obtient la valeur de la colonne spécifiée sous forme de caractère unique.
GetChars(Int32, Int64, Char[], Int32, Int32)	Lit un flux de données de caractères de la colonne spécifiée, en commençant à l'emplacement indiqué par `dataIndex`, dans la mémoire tampon, en commençant à l'emplacement indiqué par `bufferIndex`.
GetColumnSchemaAsync(CancellationToken)	Il s'agit de la version asynchrone de GetColumnSchema(DbDataReader). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le `cancellationToken` peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetColumnSchema(DbDataReader) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un `cancellationToken` déjà annulé est passé. Les exceptions levées par GetColumnSchema(DbDataReader) sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbDataReader)
GetData(Int32)	Retourne un lecteur de données imbriqué pour la colonne demandée. (Hérité de DbDataReader)
GetDataReader(Int32)	Retourne des lecteurs imbriqués sous la forme d'objets DbDataReader.
GetDataRecord(Int32)	Retourne un objet DbDataRecord imbriqué.
GetDataTypeName(Int32)	Obtient le nom du type de données de la colonne spécifiée.
GetDateTime(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime.
GetDbDataReader(Int32)	Retourne un objet DbDataReader pour l'ordinal de colonne demandé qui peut être substitué par une implémentation spécifique au fournisseur.
GetDecimal(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal.
GetDouble(Int32)	Obtient la valeur de la colonne spécifiée sous forme de nombre à virgule flottante double précision.
GetEnumerator()	Retourne un objet IEnumerator qui peut être utilisé pour itérer au sein des lignes dans le lecteur de données.
GetFieldType(Int32)	Obtient le type de données de la colonne spécifiée.
GetFieldValue<T>(Int32)	Obtient la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader)
GetFieldValueAsync<T>(Int32)	Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtient de manière asynchrone la valeur de la colonne spécifiée comme type demandé. (Hérité de DbDataReader)
GetFloat(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante simple précision.
GetGuid(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un identificateur global unique (GUID, Globally Unique IDentifier).
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetInt16(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 16 bits.
GetInt32(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d’un entier signé 32 bits.
GetInt64(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits.
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetName(Int32)	Obtient le nom de la colonne, en fonction du numéro de colonne de base zéro.
GetOrdinal(String)	Obtient l'ordinal de colonne, en fonction du nom de la colonne.
GetProviderSpecificFieldType(Int32)	Retourne le type de champ spécifique au fournisseur de la colonne spécifiée.
GetProviderSpecificValue(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet Object.
GetProviderSpecificValues(Object[])	Obtient toutes les colonnes d’attributs spécifiques au fournisseur figurant dans la collection de la ligne actuelle.
GetSchemaTable()	Retourne un DataTable qui décrit les métadonnées de colonne de DbDataReader.
GetSchemaTableAsync(CancellationToken)	Il s'agit de la version asynchrone de GetSchemaTable(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le `cancellationToken` peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchemaTable() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un `cancellationToken` déjà annulé est passé. Les exceptions levées par GetSchemaTable() sont communiquées via la propriété d'exception de tâche retournée. (Hérité de DbDataReader)
GetStream(Int32)	Obtient un flux pour récupérer les données de la colonne spécifiée. (Hérité de DbDataReader)
GetString(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet String.
GetTextReader(Int32)	Obtient un lecteur de texte pour récupérer les données de la colonne. (Hérité de DbDataReader)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(Int32)	Obtient la valeur de la colonne spécifiée sous la forme d'une instance de l'objet Object.
GetValues(Object[])	Remplit un tableau d'objets avec les valeurs de colonne de la ligne en cours.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
IsDBNull(Int32)	Obtient une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes.
IsDBNullAsync(Int32)	Obtient de manière asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. (Hérité de DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Obtient de manière asynchrone une valeur qui indique si la colonne contient des valeurs inexistantes ou manquantes. (Hérité de DbDataReader)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
NextResult()	Avance le lecteur jusqu'au résultat suivant lors de la lecture des résultats d'un lot d'instructions.
NextResultAsync()	Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader)
NextResultAsync(CancellationToken)	Avance le lecteur de manière asynchrone jusqu’au résultat suivant lors de la lecture des résultats d’un lot d’instructions. (Hérité de DbDataReader)
Read()	Avance le lecteur jusqu'à l'enregistrement suivant d'un jeu de résultats.
ReadAsync()	Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats. (Hérité de DbDataReader)
ReadAsync(CancellationToken)	Avance le lecteur de manière asynchrone jusqu’à l’enregistrement suivant d’un jeu de résultats. (Hérité de DbDataReader)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IDataRecord.GetData(Int32)

Pour obtenir une description de ce membre, consultez GetData(Int32).

(Hérité de DbDataReader)

Méthodes d’extension

CanGetColumnSchema(DbDataReader)	Obtient une valeur qui indique si un DbDataReader peut obtenir un schéma de colonne.
GetColumnSchema(DbDataReader)	Obtient le schéma de colonne (collection DbColumn) pour un DbDataReader.
Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à