DataWriter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将数据写入输出流。
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, IDataWriterfunction DataWriter(outputStream)Public NotInheritable Class DataWriter
Implements IDataWriter, IDisposable- 继承
- 属性
- 实现
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 位无符号整数值写入输出流。 |