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تدفق بدون تخزين أساسي.

انظر أيضًا