DataWriter Classe

Définition

Espace de noms:

Windows.Storage.Streams

Écrit des données dans un flux de sortie.

public ref class DataWriter sealed : IClosable, IDataWriter

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Storage.Streams.IDataWriterFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class DataWriter final : IClosable, IDataWriter

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Storage.Streams.IDataWriterFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DataWriter : System.IDisposable, IDataWriter

function DataWriter(outputStream)

Public NotInheritable Class DataWriter
Implements IDataWriter, IDisposable

Héritage

Object Platform::Object IInspectable DataWriter

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable IDataWriter

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Consultez l’exemple de code dans la rubrique DataReader .

Remarques

Les instances d’objets DataWriter ne prennent pas en charge les écritures simultanées. Si une application écrit ou détache simultanément un flux d’un instance DataWriter en cours d’écriture dans l’appel à l’objet échoue avec l’erreur HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION).

Constructeurs

DataWriter()	Crée et initialise une nouvelle instance de l’enregistreur de données.
DataWriter(IOutputStream)	Crée et initialise une nouvelle instance de l’enregistreur de données dans un flux de sortie.

Propriétés

ByteOrder	Obtient ou définit l’ordre des octets des données dans le flux de sortie.
UnicodeEncoding	Obtient ou définit l’encodage de caractères Unicode pour le flux de sortie.
UnstoredBufferLength	Obtient la taille de la mémoire tampon qui n’a pas été utilisée.

Méthodes

Close()	Ferme le flux actuel et libère les ressources système.
DetachBuffer()	Détache la mémoire tampon associée à l’enregistreur de données.
DetachStream()	Détache le flux associé à l’enregistreur de données.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
FlushAsync()	Vide les données de manière asynchrone.
MeasureString(String)	Obtient la taille d’une chaîne.
StoreAsync()	Valide les données de la mémoire tampon dans le flux de sortie. Cette méthode ne doit être appelée que lorsque le DataWriter écrit dans un flux ; elle échoue lorsque le magasin sous-jacent est une mémoire tampon.
WriteBoolean(Boolean)	Écrit une valeur booléenne dans le flux de sortie.
WriteBuffer(IBuffer)	Écrit le contenu de la mémoire tampon spécifiée dans le flux de sortie.
WriteBuffer(IBuffer, UInt32, UInt32)	Écrit les octets spécifiés d’une mémoire tampon dans le flux de sortie.
WriteByte(Byte)	Écrit une valeur d’octet dans le flux de sortie.
WriteBytes(Byte[])	Écrit un tableau de valeurs d’octets dans le flux de sortie.
WriteDateTime(DateTime)	Écrit une valeur de date et d’heure dans le flux de sortie.
WriteDouble(Double)	Écrit une valeur à virgule flottante dans le flux de sortie.
WriteGuid(Guid)	Écrit une valeur GUID dans le flux de sortie.
WriteInt16(Int16)	Écrit une valeur entière 16 bits dans le flux de sortie.
WriteInt32(Int32)	Écrit une valeur entière 32 bits dans le flux de sortie.
WriteInt64(Int64)	Écrit une valeur entière 64 bits dans le flux de sortie.
WriteSingle(Single)	Écrit une valeur à virgule flottante dans le flux de sortie.
WriteString(String)	Écrit une valeur de chaîne dans le flux de sortie.
WriteTimeSpan(TimeSpan)	Écrit une valeur d’intervalle de temps dans le flux de sortie.
WriteUInt16(UInt16)	Écrit une valeur entière non signée 16 bits dans le flux de sortie.
WriteUInt32(UInt32)	Écrit une valeur entière non signée 32 bits dans le flux de sortie.
WriteUInt64(UInt64)	Écrit une valeur entière non signée 64 bits dans le flux de sortie.

Voir aussi

• DataReader
• DataWriterStoreOperation
• Exemple de sérialisation et désérialisation des données (Windows 10)
• Exemple d’accès aux fichiers (Windows 10)
• Exemple DatagramSocket (Windows 10)
• Exemple StreamSocket (Windows 10)
• Exemple de périphérique USB personnalisé (Windows 10)