EncodingTranslatorStream - класс

This class is a stream designed to perform character encoding translation from one encoding to another.

Definition

Пространство имён: Tessa.Platform.IO
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
public class EncodingTranslatorStream : Stream
Inheritance
Object    MarshalByRefObject    Stream    EncodingTranslatorStream

Конструкторы

EncodingTranslatorStream(Stream, Boolean, Encoding, Boolean) Constructor. Specifies an output encoding, and a byte order mark detection option for the input stream
EncodingTranslatorStream(Stream, Encoding, Encoding, Boolean) Constructor. Specifies the input and output encoding.
EncodingTranslatorStream(Stream, Encoding, Boolean, Encoding, Boolean) Constructor. Specifies the input and output encoding, and a byte order mark detection option for the input stream

Свойства

CanRead
(Переопределяет StreamCanRead)
CanSeek
(Переопределяет StreamCanSeek)
CanTimeoutGets a value that determines whether the current stream can time out.
(Унаследован от Stream)
CanWrite
(Переопределяет StreamCanWrite)
Length Returns the length of the string in bytes. Note, depending on the encoding type of the stream, the byte length will vary, as characters may require multiple bytes for certain encodings. Some encodings allow different byte lengths depending on the character. This function will return the maximum amount of bytes that the string may take, as returning the actual requires processing the entire string which is time and memory consuming.
(Переопределяет StreamLength)
Position The actual position in bytes (not characters)
(Переопределяет StreamPosition)
ReadTimeoutGets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.
(Унаследован от Stream)
WriteTimeoutGets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.
(Унаследован от Stream)

Методы

BeginReadBegins an asynchronous read operation. (Consider using ReadAsync(Byte, Int32, Int32) instead.)
(Унаследован от Stream)
BeginWriteBegins an asynchronous write operation. (Consider using WriteAsync(Byte, Int32, Int32) instead.)
(Унаследован от Stream)
CloseCloses the current stream and releases any resources (such as sockets and file handles) associated with the current stream. Instead of calling this method, ensure that the stream is properly disposed.
(Унаследован от Stream)
CopyTo(Stream)Reads the bytes from the current stream and writes them to another stream.
(Унаследован от Stream)
CopyTo(Stream, Int32)Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.
(Унаследован от Stream)
CopyToAsync(Stream)Asynchronously reads the bytes from the current stream and writes them to another stream.
(Унаследован от Stream)
CopyToAsync(Stream, Int32)Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size.
(Унаследован от Stream)
CopyToAsync(Stream, CancellationToken)Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified cancellation token.
(Унаследован от Stream)
CopyToAsync(Stream, Int32, CancellationToken)Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.
(Унаследован от Stream)
CreateWaitHandleAllocates a WaitHandle object.
(Унаследован от Stream)
Устарело.
DisposeReleases all resources used by the Stream.
(Унаследован от Stream)
Dispose(Boolean)Освобождает неуправляемые ресурсы, используемые объектом EncodingTranslatorStream, а при необходимости освобождает также управляемые ресурсы
(Переопределяет StreamDispose(Boolean))
DisposeAsync
(Переопределяет StreamDisposeAsync)
EndReadWaits for the pending asynchronous read to complete. (Consider using ReadAsync(Byte, Int32, Int32) instead.)
(Унаследован от Stream)
EndWriteEnds an asynchronous write operation. (Consider using WriteAsync(Byte, Int32, Int32) instead.)
(Унаследован от Stream)
EqualsDetermines whether the specified object is equal to the current object.
(Унаследован от Object)
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Унаследован от Object)
Flush
(Переопределяет StreamFlush)
FlushAsyncAsynchronously clears all buffers for this stream and causes any buffered data to be written to the underlying device.
(Унаследован от Stream)
FlushAsync(CancellationToken)Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.
(Унаследован от Stream)
GetHashCodeServes as the default hash function.
(Унаследован от Object)
GetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance.
(Унаследован от MarshalByRefObject)
GetTypeGets the Type of the current instance.
(Унаследован от Object)
InitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance.
(Унаследован от MarshalByRefObject)
MemberwiseCloneCreates a shallow copy of the current Object.
(Унаследован от Object)
MemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object.
(Унаследован от MarshalByRefObject)
ObjectInvariantProvides support for a Contract.
(Унаследован от Stream)
Устарело.
Read(SpanByte)When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
(Переопределяет StreamRead(SpanByte))
Read(Byte, Int32, Int32) Reads bytes from the stream. Bytes will be returned in the output encoding specified, regardless of the input encoding
(Переопределяет StreamRead(Byte, Int32, Int32))
ReadAsync(MemoryByte, CancellationToken)Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.
(Переопределяет StreamReadAsync(MemoryByte, CancellationToken))
ReadAsync(Byte, Int32, Int32)Asynchronously reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.
(Унаследован от Stream)
ReadAsync(Byte, Int32, Int32, CancellationToken)Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.
(Переопределяет StreamReadAsync(Byte, Int32, Int32, CancellationToken))
ReadByteReads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.
(Переопределяет StreamReadByte)
Seek
(Переопределяет StreamSeek(Int64, SeekOrigin))
SetLength
(Переопределяет StreamSetLength(Int64))
ToStringReturns a string that represents the current object.
(Унаследован от Object)
Write(ReadOnlySpanByte)When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.
(Унаследован от Stream)
Write(Byte, Int32, Int32)
(Переопределяет StreamWrite(Byte, Int32, Int32))
WriteAsync(ReadOnlyMemoryByte, CancellationToken)Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.
(Унаследован от Stream)
WriteAsync(Byte, Int32, Int32)Asynchronously writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.
(Унаследован от Stream)
WriteAsync(Byte, Int32, Int32, CancellationToken)Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.
(Унаследован от Stream)
WriteByteWrites a byte to the current position in the stream and advances the position within the stream by one byte.
(Унаследован от Stream)

Методы расширения

AsMemoryStreamAsync Возвращает поток stream, преобразованный к типу MemoryStream. Если его тип отличается от MemoryStream, то его содержимое будет скопировано в созданный объект MemoryStream, после чего исходный stream будет освобождён, но только если параметр disposeNonMemoryStream равен true.
(Определяется IOExtensions)
CalculateStreamLengthAsync Вычисляет длину потока посредством его чтения, но отбрасывая сам контент.
(Определяется IOExtensions)
Get
(Определяется ComHelper)
Invoke
(Определяется ComHelper)
ReadAllBytes Выполняет синхронное чтение всех данных потока в виде одного массива байт. Чтение выполняется до того момента, как поток перестанет возвращать данные, при этом метод не использует свойство Length для определения количества считываемых данных.
(Определяется IOExtensions)
ReadAllBytesAsync Выполняет асинхронное чтение всех данных потока в виде одного массива байт. Чтение выполняется до того момента, как поток перестанет возвращать данные, при этом метод не использует свойство Length для определения количества считываемых данных.
(Определяется IOExtensions)
ReadBase64Async Возвращает контент потока в формате base64.
(Определяется IOExtensions)
ReadByteAsync Выполняет асинхронное чтение целочисленного значения Byte из потока.
(Определяется IOExtensions)
ReadBytesExact Выполняет чтение данных из потока stream и записывает их в возвращаемый массив байт, который имеет заданный размер length байт.
(Определяется IOExtensions)
ReadBytesExactAsync Выполняет асинхронное чтение данных из потока stream и записывает их в возвращаемый массив байт, который имеет заданный размер length байт.
(Определяется IOExtensions)
ReadExact Выполняет чтение указанного количества байт из потока в буфер. В результате выполнения метода либо буфер должен быть заполнен, либо поток завершился раньше, чем данные были прочитаны. Возвращает количество действительно прочитанных байт, которое может быть меньше указанного количества только в том случае, если поток завершился.
(Определяется IOExtensions)
ReadExactAsync Выполняет асинхронное чтение указанного количества байт из потока в буфер. В результате выполнения метода либо буфер должен быть заполнен, либо поток завершился раньше, чем данные были прочитаны. Возвращает количество действительно прочитанных байт, которое может быть меньше указанного количества только в том случае, если поток завершился.
(Определяется IOExtensions)
ReadGuid Выполняет чтение значения Guid из потока.
(Определяется IOExtensions)
ReadGuidAsync Выполняет асинхронное чтение значения Guid из потока.
(Определяется IOExtensions)
ReadInt16Async Выполняет асинхронное чтение целочисленного значения Int16 из потока.
(Определяется IOExtensions)
ReadInt32 Выполняет чтение целочисленного значения Int32 из потока.
(Определяется IOExtensions)
ReadInt32Async Выполняет асинхронное чтение целочисленного значения Int32 из потока.
(Определяется IOExtensions)
ReadInt64 Выполняет чтение целочисленного значения Int32 из потока.
(Определяется IOExtensions)
ReadInt64Async Выполняет асинхронное чтение целочисленного значения Int32 из потока.
(Определяется IOExtensions)
ReadString Выполняет чтение значения string из потока.
(Определяется IOExtensions)
ReadStringAsync Выполняет асинхронное чтение значения string из потока.
(Определяется IOExtensions)
Set
(Определяется ComHelper)
TryReadPrimitiveTypeAsync Выполняет асинхронное чтение объекта примитивного типа из потока. Возвращает значение объекта или признак того, что тип объекта type является примитивным, и объект был прочитан из потока.
(Определяется IOExtensions)
TryWritePrimitiveTypeAsync Выполняет асинхронную запись объекта примитивного типа в поток. Возвращает признак того, что тип объекта obj является примитивным, и объект был записан в поток.
(Определяется IOExtensions)
Write Выполняет запись целочисленного значения Byte в поток.
(Определяется IOExtensions)
Write Выполняет запись значения Guid в поток.
(Определяется IOExtensions)
Write Выполняет запись целочисленного значения Int16 в поток.
(Определяется IOExtensions)
Write Выполняет запись целочисленного значения Int32 в поток.
(Определяется IOExtensions)
Write Выполняет запись целочисленного значения Int32 в поток.
(Определяется IOExtensions)
Write Выполняет запись значения string в поток.
(Определяется IOExtensions)
WriteAsync Выполняет асинхронную запись целочисленного значения Byte в поток.
(Определяется IOExtensions)
WriteAsync Выполняет запись значения Guid в поток.
(Определяется IOExtensions)
WriteAsync Выполняет асинхронную запись целочисленного значения Int16 в поток.
(Определяется IOExtensions)
WriteAsync Выполняет асинхронную запись целочисленного значения Int32 в поток.
(Определяется IOExtensions)
WriteAsync Выполняет асинхронную запись целочисленного значения Int32 в поток.
(Определяется IOExtensions)
WriteAsync Выполняет асинхронную запись значения string в поток.
(Определяется IOExtensions)
WriteStream Записывает все данные из потока source в поток target.
(Определяется IOExtensions)
WriteStreamAsync Записывает все данные из потока source в поток target.
(Определяется IOExtensions)
WriteTextAsync Записывает текст в поток в указанной кодировке. Также записывает преамбулу (BOM) в соответствии с её наличием в кодировке encoding, что также определяется тем, что stream находится в нулевой позиции, или если он не сообщает свою позицию, т.е. CanSeek равно false (по этим же правилам работает StreamWriter).
(Определяется IOExtensions)
WriteTextAsync Записывает текст в поток в указанной кодировке. Также записывает преамбулу (BOM) в соответствии с её наличием в кодировке encoding, что также определяется тем, что stream находится в нулевой позиции, или если он не сообщает свою позицию, т.е. CanSeek равно false (по этим же правилам работает StreamWriter).
(Определяется IOExtensions)

См. также