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, IDataWriter
function 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 位无符号整数值写入输出流。 |