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, 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 |
Возвращает или задает кодировку символов Юникода для выходного потока. |
| 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-разрядное целое число без знака в выходной поток. |