فئة System::IO::FileStream

FileStream class

تمثل تدفق ملف يدعم عمليات القراءة والكتابة المتزامنة وغير المتزامنة. يجب تخصيص كائنات هذه الفئة فقط باستخدام الدالة System::MakeObject(). لا تقم أبدًا بإنشاء نسخة من هذا النوع على المكدس أو باستخدام المشغل new، لأن ذلك سيتسبب في أخطاء وقت التشغيل أو أعطال التأكيد. احرص دائمًا على تغليف هذه الفئة في مؤشر System::SmartPtr واستخدام هذا المؤشر لتمريره إلى الدوال كمعامل.

class FileStream : public System::IO::Stream

الطرق

طريقةالوصف
Close() overrideيغلق كائن FileStream الحالي.
FileStream(const String&, FileMode)ينشئ نسخة جديدة من فئة FileStream ويُهيئها بالمعلمات المحددة.
FileStream(const String&, FileMode, FileAccess, FileShare, int32_t, FileOptions)ينشئ نسخة جديدة من فئة FileStream ويُهيئها بالمعلمات المحددة.
FileStream(const String&, FileMode, FileAccess, FileShare, int32_t, bool)ينشئ نسخة جديدة من فئة FileStream ويُهيئها بالمعلمات المحددة.
FileStream(const FileStream&)
Flush() overrideيمسح مخازن هذا التدفق ويكتب جميع البيانات المخزنة مؤقتًا إلى الملف الأساسي.
Flush(bool)يمسح مخازن هذا التدفق ويكتب جميع البيانات المخزنة مؤقتًا إلى الملف الأساسي. مرادف للطريقة Flush().
FlushAsync(const Threading::CancellationToken&) overrideيمسح بشكل غير متزامن جميع المخازن المؤقتة لهذا الدفق، مما يؤدي إلى كتابة أي بيانات مخزنة مؤقتًا إلى الجهاز الأساسي، ويراقب طلبات الإلغاء.
get_CanRead() const overrideيحدد ما إذا كان الدفق قابلًا للقراءة.
get_CanSeek() const overrideيحدد ما إذا كان التدفق يدعم البحث.
get_CanWrite() const overrideيحدد ما إذا كان التدفق قابلًا للكتابة.
get_Length() const overrideيعيد طول التدفق بالبايت.
get_Name() constيعيد اسم الملف الذي يحيط به كائن FileStream الحالي.
get_Position() const overrideيعيد الموضع الحالي للتدفق.
operator=(const FileStream&)
Read(const ArrayPtr<uint8_t>&, int32_t, int32_t) overrideيقرأ عدد البايتات المحدد من التدفق ويكتبها إلى مصفوفة البايتات المحددة.
Read(const System::Details::ArrayView<uint8_t>&, int32_t, int32_t) overrideيقرأ عدد البايتات المحدد من التدفق ويكتبها إلى مصفوفة البايتات المحددة.
ReadAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t, const Threading::CancellationToken&) overrideيقرأ بشكل غير متزامن تسلسلًا من البايتات من الدفق الحالي، ويقدم الموضع داخل الدفق بعدد البايتات المقروءة، ويراقب طلبات الإلغاء.
ReadByte() overrideيقرأ بايتًا واحدًا من الدفق ويعيد قيمة عدد صحيح 32-بت مكافئة لقيمة البايت المقروء.
Seek(int64_t, SeekOrigin) overrideيضبط موضع التدفق الممثل بالكائن الحالي.
set_Position(int64_t) overrideيفرغ التدفق ثم يضبط موقعه.
SetLength(int64_t) overrideيضبط طول التدفق الممثل بالكائن الحالي.
Write(const ArrayPtr<uint8_t>&, int32_t, int32_t) overrideيكتب النطاق الفرعي المحدد من البايتات من مصفوفة البايتات المحددة إلى التدفق.
Write(const System::Details::ArrayView<uint8_t>&, int32_t, int32_t) overrideيكتب النطاق الفرعي المحدد من البايتات من مصفوفة البايتات المحددة إلى التدفق.
WriteAsync(const ArrayPtr<uint8_t>&, int32_t, int32_t, const Threading::CancellationToken&) overrideيكتب بشكل غير متزامن تسلسلًا من البايتات إلى الدفق الحالي، ويقدم الموضع الحالي داخل هذا الدفق بعدد البايتات المكتوبة، ويراقب طلبات الإلغاء.
WriteByte(uint8_t) overrideيكتب القيمة المحددة من عدد صحيح غير موقع 8-بت إلى الدفق.
~FileStream()المدمر.

الحقول

حقلالوصف
static constexpr DefaultBufferSizeالقيمة الافتراضية لعدد البايتات المخزنة مؤقتًا أثناء عمليات القراءة والكتابة.
static Nullتدفق بدون تخزين أساسي.

انظر أيضًا