DataWriter 类

定义

将数据写入输出流。

public ref class DataWriter sealed : IClosable, IDataWriter
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Storage.Streams.IDataWriterFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DataWriter final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Storage.Streams.IDataWriterFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DataWriter : System.IDisposable, 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
继承
Object Platform::Object IInspectable DataWriter
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

请参阅 DataReader 主题中的代码示例。

注解

DataWriter 对象的实例不支持并发写入。 如果应用程序同时从 DataWriter 实例写入或分离流,而该流正在写入对象调用将失败并HRESULT_FROM_WIN32 (ERROR_INVALID_OPERATION) 错误。

构造函数

DataWriter()

创建并初始化数据编写器的新实例。

DataWriter(IOutputStream)

创建数据编写器的新实例并将其初始化为输出流。

属性

ByteOrder

获取或设置输出流中数据的字节顺序。

UnicodeEncoding

获取或设置输出流的 Unicode 字符编码。

UnstoredBufferLength

获取尚未使用的缓冲区的大小。

方法

Close()

关闭当前流并释放系统资源。

DetachBuffer()

分离与数据编写器关联的缓冲区。

DetachStream()

分离与数据编写器关联的流。

Dispose()

执行与释放或重置非托管资源关联的应用程序定义的任务。

FlushAsync()

异步刷新数据。

MeasureString(String)

获取字符串的大小。

StoreAsync()

将缓冲区中的数据提交到输出流。 仅当 DataWriter 写入流时,才应调用此方法;当基础存储为缓冲区时,它将失败。

WriteBoolean(Boolean)

将布尔值写入输出流。

WriteBuffer(IBuffer)

将指定缓冲区的内容写入输出流。

WriteBuffer(IBuffer, UInt32, UInt32)

将指定的字节从缓冲区写入输出流。

WriteByte(Byte)

将字节值写入输出流。

WriteBytes(Byte[])

将字节值的数组写入输出流。

WriteDateTime(DateTime)

将日期和时间值写入输出流。

WriteDouble(Double)

将浮点值写入输出流。

WriteGuid(Guid)

GUID 值写入输出流。

WriteInt16(Int16)

将 16 位整数值写入输出流。

WriteInt32(Int32)

将 32 位整数值写入输出流。

WriteInt64(Int64)

将 64 位整数值写入输出流。

WriteSingle(Single)

将浮点值写入输出流。

WriteString(String)

将字符串值写入输出流。

WriteTimeSpan(TimeSpan)

将时间间隔值写入输出流。

WriteUInt16(UInt16)

将 16 位无符号整数值写入输出流。

WriteUInt32(UInt32)

将 32 位无符号整数值写入输出流。

WriteUInt64(UInt64)

将 64 位无符号整数值写入输出流。

适用于

另请参阅