System::IO::FileStream class

FileStream class

Vertegenwoordigt een bestandsstroom die synchronische en asynchrone lees- en schrijfoperaties ondersteunt. Objecten van deze klasse mogen alleen worden gealloceerd met de functie System::MakeObject(). Maak nooit een instantie van dit type op de stack of met operator new, omdat dit runtime‑fouten en/of assertiefouten oplevert. Wikkel deze klasse altijd in een System::SmartPtr pointer en gebruik deze pointer om deze als argument aan functies door te geven.

class FileStream : public System::IO::Stream

Methoden

MethodeBeschrijving
Close() overrideSluit het huidige FileStream object.
FileStream(const String&, FileMode)Construeert een nieuwe instantie van de FileStream klasse en initialiseert deze met de opgegeven parameters.
FileStream(const String&, FileMode, FileAccess, FileShare, int32_t, FileOptions)Construeert een nieuwe instantie van de FileStream klasse en initialiseert deze met de opgegeven parameters.
FileStream(const String&, FileMode, FileAccess, FileShare, int32_t, bool)Construeert een nieuwe instantie van de FileStream klasse en initialiseert deze met de opgegeven parameters.
FileStream(const FileStream&)
Flush() overrideLeegt de buffers van deze stroom en schrijft alle gebufferde gegevens naar het onderliggende bestand.
Flush(bool)Leegt de buffers van deze stroom en schrijft alle gebufferde gegevens naar het onderliggende bestand. Synoniem voor de methode Flush().
FlushAsync(const Threading::CancellationToken&) overrideMaakt asynchroon alle buffers voor deze stream leeg, zorgt ervoor dat alle gebufferde gegevens naar het onderliggende apparaat worden geschreven, en bewaakt annuleringsverzoeken.
get_CanRead() const overrideBepaalt of de stream leesbaar is.
get_CanSeek() const overrideBepaalt of de stroom zoeken ondersteunt.
get_CanWrite() const overrideBepaalt of de stroom beschrijfbaar is.
get_Length() const overrideRetourneert de lengte van de stroom in bytes.
get_Name() constRetourneert de naam van het bestand dat door het huidige FileStream object wordt ingekapseld.
get_Position() const overrideRetourneert de huidige positie van de stroom.
operator=(const FileStream&)
Read(const ArrayPtr<uint8_t>&, int32_t, int32_t) overrideLeest het opgegeven aantal bytes van de stream en schrijft ze naar de opgegeven byte‑array.
Read(const System::Details::ArrayView<uint8_t>&, int32_t, int32_t) overrideLeest het opgegeven aantal bytes van de stream en schrijft ze naar de opgegeven byte‑array.
ReadAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t, const Threading::CancellationToken&) overrideLeest asynchroon een reeks bytes van de huidige stream, verplaatst de positie binnen de stream met het aantal gelezen bytes, en bewaakt annuleringsverzoeken.
ReadByte() overrideLeest een enkel byte uit de stream en retourneert een 32‑bit geheel getalwaarde die gelijk is aan de waarde van het gelezen byte.
Seek(int64_t, SeekOrigin) overrideStelt de positie in van de stream die wordt vertegenwoordigd door het huidige object.
set_Position(int64_t) overrideLeegt de stream en stelt vervolgens de positie van de stream in.
SetLength(int64_t) overrideStelt de lengte in van de stream die wordt vertegenwoordigd door het huidige object.
Write(const ArrayPtr<uint8_t>&, int32_t, int32_t) overrideSchrijft het opgegeven subbereik van bytes van de opgegeven byte‑array naar de stream.
Write(const System::Details::ArrayView<uint8_t>&, int32_t, int32_t) overrideSchrijft het opgegeven subbereik van bytes van de opgegeven byte‑array naar de stream.
WriteAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t, const Threading::CancellationToken&) overrideSchrijft asynchroon een reeks bytes naar de huidige stream, verplaatst de huidige positie binnen deze stream met het aantal geschreven bytes, en bewaakt annuleringsverzoeken.
WriteByte(uint8_t) overrideSchrijft de opgegeven onondertekende 8‑bit gehele getalwaarde naar de stream.
~FileStream()Destructor.

Velden

VeldBeschrijving
static constexpr DefaultBufferSizeStandaardwaarde van het aantal bytes dat gebufferd wordt tijdens lees- en schrijfoperaties.
static NullEen stream zonder onderliggende opslag.

Zie ook