Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

StreamReader.ReadBlockAsync, méthode

.NET Framework 4.5

Lit un nombre maximal spécifié de caractères à partir du flux actuel de manière asynchrone, et écrit les données dans une mémoire tampon, en commençant à l'index spécifié.

Espace de noms :  System.IO
Assembly :  mscorlib (dans mscorlib.dll)

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public override Task<int> ReadBlockAsync(
	char[] buffer,
	int index,
	int count
)

Paramètres

buffer
Type : System.Char[]
Lorsque cette méthode est retournée, contient le tableau de caractères spécifié dont les valeurs comprises entre index et (index + count - 1) sont remplacées par les caractères lus dans la source en cours.
index
Type : System.Int32
Position dans buffer à partir de laquelle commencer l'écriture.
count
Type : System.Int32
Nombre maximal de caractères à lire. Si la fin du flux est atteinte avant que le nombre de caractères spécifié soit écrit dans la mémoire tampon, la méthode est retournée.

Valeur de retour

Type : System.Threading.Tasks.Task<Int32>
Tâche qui représente l'opération de lecture asynchrone. La valeur du paramètre TResult contient le nombre total d'octets lus dans la mémoire tampon. La valeur de résultat peut être inférieure au nombre d'octets demandés si le nombre d'octets actuellement disponibles est inférieur au nombre demandé, ou elle peut avoir la valeur 0 (zéro) si la fin du flux a été atteinte.

ExceptionCondition
ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

index ou count est négatif.

ArgumentException

La somme de index et de count est supérieure à la longueur de la mémoire tampon.

ObjectDisposedException

Le flux a été supprimé.

InvalidOperationException

Lecteur est en cours d'utilisation par une opération de lecture précédente.

La tâche ne se termine pas avant que le nombre de caractères spécifié par le paramètre count soient lus, ou lorsque la fin d'un flux a été atteinte.

RemarqueRemarque

L'attribut HostProtectionAttribute appliqué à ce type ou membre a la valeur de propriété Resources suivante : ExternalThreading. HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d'informations, consultez la classe HostProtectionAttribute ou Attributs de programmation et de protection des hôtes SQL Server.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

Afficher:
© 2014 Microsoft