Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.
0 sur 1 ont trouvé cela utile - Évaluez ce sujet

Stream.BeginWrite, méthode

Débute une opération d'écriture asynchrone.

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

'Déclaration
Public Overridable Function BeginWrite ( _
	buffer As Byte(), _
	offset As Integer, _
	count As Integer, _
	callback As AsyncCallback, _
	state As Object _
) As IAsyncResult
'Utilisation
Dim instance As Stream
Dim buffer As Byte()
Dim offset As Integer
Dim count As Integer
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = instance.BeginWrite(buffer, offset, count, callback, state)
public IAsyncResult BeginWrite (
	byte[] buffer, 
	int offset, 
	int count, 
	AsyncCallback callback, 
	Object state
)
public function BeginWrite (
	buffer : byte[], 
	offset : int, 
	count : int, 
	callback : AsyncCallback, 
	state : Object
) : IAsyncResult

Paramètres

buffer

Mémoire tampon dans laquelle écrire les données.

offset

Offset d'octet dans buffer à partir duquel commencer l'écriture.

count

Nombre maximal d'octets à écrire.

callback

Rappel asynchrone optionnel à appeler lorsque l'écriture est terminée.

state

Un objet fourni par l'utilisateur qui distingue cette demande d'écriture asynchrone des autres demandes.

Valeur de retour

IAsyncResult représentant l'écriture asynchrone, qui pourrait toujours être en attente.
Type d'exceptionCondition

IOException

Tentative d'écriture asynchrone au-delà de la fin du flux, ou une erreur disque s'est produite.

ArgumentException

Un ou plusieurs arguments ne sont pas valides.

ObjectDisposedException

Des méthodes ont été appelées après que le flux a été fermé.

NotSupportedException

L'implémentation du Stream en cours ne prend pas en charge l'opération d'écriture.

Pour obtenir un exemple de création de fichier et d'écriture de texte dans un fichier, consultez Comment : écrire du texte dans un fichier. Pour obtenir un exemple de lecture de texte à partir d'un fichier, consultez Comment : lire du texte dans un fichier. Pour obtenir un exemple de lecture et d'écriture dans un fichier binaire, consultez Comment : lire et écrire dans un fichier de données créé récemment. Pour obtenir un exemple d'E/S de fichier asynchrone, consultez E/S sur fichier asynchrones.

L'implémentation par défaut de BeginWrite sur un flux appelle la méthode Write de manière synchrone, ce qui signifie que Write peut se bloquer sur certains flux. Toutefois, les instances de classes telles que FileStream et NetworkStream prennent totalement en charge les opérations asynchrones si les instances ont été ouvertes de manière asynchrone. En conséquence, les appels de BeginWrite ne se bloqueront pas sur ces flux. Vous pouvez substituer BeginWrite (en utilisant des délégués async, par exemple) afin de fournir un comportement asynchrone.

Passez le IAsyncResult retourné par la méthode en cours à EndWrite pour confirmer la fin de l'écriture et libérer les ressources de manière appropriée. EndWrite doit être appelé une fois pour chaque appel à BeginWrite. Ceci peut être effectué à l'aide du même code qui a appelé BeginWrite ou dans un rappel passé à BeginWrite. Si une erreur se produit pendant une écriture asynchrone, aucune exception n'est levée aussi longtemps que EndWrite n'est pas appelé avec le IAsyncResult retourné par cette méthode.

Si un flux est accessible en écriture, l'écriture à la fin de celui-ci l'étendra.

La position actuelle dans le flux est mise à jour lorsque la lecture ou l'écriture asynchrone est effectuée et non à la fin de l'opération d'E/S. De multiples demandes asynchrones simultanées rendent l'ordre d'exécution des demandes incertain.

Utilisez la propriété CanWrite pour déterminer si l'instance en cours prend en charge l'écriture.

Si un flux est fermé ou que vous passez un argument non valide, des exceptions sont immédiatement levées à partir de BeginWrite. Les erreurs qui se produisent lors d'une demande d'écriture asynchrone, telles que la défaillance d'un disque pendant la demande d'E/S, surviennent sur le thread ThreadPool et lèvent des exceptions lors de l'appel de EndWrite.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft. Tous droits réservés.