StreamContainer
Inheritance: java.lang.Object, com.aspose.imaging.DisposableObject
All Implemented Interfaces: com.aspose.internal.interfaces.ISynchronizable
public class StreamContainer extends DisposableObject implements ISynchronizable
يمثل حاوية تدفق تحتوي على التدفق وتوفر روتينات معالجة التدفق.
المنشئات
| المنشئ | الوصف |
|---|---|
| StreamContainer(InputStream stream) | يُنشئ مثيلًا جديدًا من الفئة StreamContainer. |
| StreamContainer(System.IO.Stream stream) | يُنشئ مثيلًا جديدًا من الفئة StreamContainer. |
| StreamContainer(InputStream stream, boolean disposeStream) | يُنشئ مثيلًا جديدًا من الفئة StreamContainer. |
| StreamContainer(System.IO.Stream stream, boolean disposeStream) | يُنشئ مثيلًا جديدًا من الفئة StreamContainer. |
الحقول
| حقل | الوصف |
|---|---|
| READ_WRITE_BYTES_COUNT | يحدد عدد البايتات للقراءة والكتابة عند القراءة المتسلسلة. |
الطرق
| طريقة | الوصف |
|---|---|
| to_Stream(StreamContainer streamContainer) | يُجري تحويلًا صريحًا من com.aspose.imaging.StreamContainer إلى System.IO.Stream. |
| getSyncRoot() | يحصل على كائن يمكن استخدامه لمزامنة الوصول إلى المورد المتزامن. |
| getPosition() | يحصل أو يضبط الموضع الحالي داخل الدفق. |
| setPosition(long value) | يحصل أو يضبط الموضع الحالي داخل الدفق. |
| getStream() | يحصل على تدفق البيانات. |
| isStreamDisposedOnClose() | يحصل على قيمة تشير إلى ما إذا كان هذا الدفق يتم التخلص منه عند الإغلاق. |
| getLength() | يحصل أو يضبط طول الدفق بالبايتات. |
| setLength(long value) | يحصل أو يضبط طول الدفق بالبايتات. |
| canRead() | يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم القراءة. |
| canSeek() | يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم السعي. |
| canWrite() | يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم الكتابة. |
| flush() | يمسح جميع المخازن المؤقتة لهذا الدفق ويتسبب في كتابة أي بيانات مخزنة مؤقتًا إلى الجهاز الأساسي. |
| write(byte[] bytes) | يكتب جميع البايتات المحددة إلى الدفق. |
| writeByte(byte value) | يكتب بايتًا إلى الموضع الحالي في الدفق ويُقدم الموضع داخل الدفق بايتًا واحدًا. |
| read(byte[] bytes) | يقرأ البايتات لملء المخزن المؤقت للبايتات المحدد. |
| toBytes() | يحوّل بيانات الدفق إلى مصفوفة byte. |
| toBytes(long position, long bytesCount) | يحوّل بيانات الدفق إلى مصفوفة byte. |
| read(byte[] buffer, int offset, int count) | يقرأ تسلسلًا من البايتات من الدفق الحالي ويقدّم الموضع داخل الدفق بعدد البايتات المقروءة. |
| readByte() | يقرأ بايتًا من الدفق ويقدّم الموضع داخل الدفق بايتًا واحدًا، أو يُعيد -1 إذا كان عند نهاية الدفق. |
| seek(long offset, int origin) | يضبط الموضع داخل الدفق الحالي. |
| seekBegin() | يضبط موضع الدفق إلى بداية الدفق. |
| write(byte[] buffer, int offset, int count) | يكتب تسلسلًا من البايتات إلى الدفق الحالي ويقدّم الموضع الحالي داخل هذا الدفق بعدد البايتات المكتوبة. |
| save(OutputStream destinationStream) | يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. |
| save(OutputStream destinationStream, int bufferSize) | يحفظ (ينسخ) جميع بيانات الدفق إلى الدفق المحدد. |
| save(OutputStream destinationStream, int bufferSize, long length) | يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. |
| save(String filePath) | يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. |
| save(String filePath, int bufferSize) | يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. |
| save(String filePath, int bufferSize, long length) | يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. |
| writeTo(StreamContainer streamContainer) | ينسخ البيانات المحتواة إلى StreamContainer آخر. |
| writeTo(StreamContainer streamContainer, long length) | ينسخ البيانات المحتواة إلى StreamContainer آخر. |
StreamContainer(InputStream stream)
public StreamContainer(InputStream stream)
يُنشئ مثيلًا جديدًا من الفئة StreamContainer.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| تدفق | java.io.InputStream | التدفق. |
StreamContainer(System.IO.Stream stream)
public StreamContainer(System.IO.Stream stream)
يُنشئ مثيلًا جديدًا من الفئة StreamContainer.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| تدفق | com.aspose.ms.System.IO.Stream | التدفق. |
StreamContainer(InputStream stream, boolean disposeStream)
public StreamContainer(InputStream stream, boolean disposeStream)
يُنشئ مثيلًا جديدًا من الفئة StreamContainer.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| تدفق | java.io.InputStream | دفق البيانات. |
| disposeStream | boolean | إذا تم تعيينه إلى true سيتم التخلص من الدفق عندما يتم التخلص من الحاوية. |
StreamContainer(System.IO.Stream stream, boolean disposeStream)
public StreamContainer(System.IO.Stream stream, boolean disposeStream)
يُنشئ مثيلًا جديدًا من الفئة StreamContainer.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| تدفق | com.aspose.ms.System.IO.Stream | دفق البيانات. |
| disposeStream | boolean | إذا تم تعيينه إلى true سيتم التخلص من الدفق عندما يتم التخلص من الحاوية. |
READ_WRITE_BYTES_COUNT
public static final int READ_WRITE_BYTES_COUNT
يحدد عدد البايتات للقراءة والكتابة عند القراءة المتسلسلة.
to_Stream(StreamContainer streamContainer)
public static System.IO.Stream to_Stream(StreamContainer streamContainer)
يُجري تحويلًا صريحًا من com.aspose.imaging.StreamContainer إلى System.IO.Stream.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| streamContainer | StreamContainer | حاوية الدفق. |
Returns: com.aspose.ms.System.IO.Stream - نتيجة التحويل.
getSyncRoot()
public Object getSyncRoot()
يحصل على كائن يمكن استخدامه لمزامنة الوصول إلى المورد المتزامن.
القيمة: الكائن الذي يمكن استخدامه لمزامنة الوصول إلى المورد المتزامن.
Returns: java.lang.Object
getPosition()
public long getPosition()
يحصل أو يعيّن الموضع الحالي داخل الدفق. تمثل هذه القيمة الإزاحة من موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer.
القيمة: موضع الدفق الحالي.
Returns: long
setPosition(long value)
public void setPosition(long value)
يحصل أو يعيّن الموضع الحالي داخل الدفق. تمثل هذه القيمة الإزاحة من موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer.
القيمة: موضع الدفق الحالي.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| value | long |
getStream()
public InputStream getStream()
يحصل على تدفق البيانات.
القيمة: دفق البيانات.
Returns: java.io.InputStream
isStreamDisposedOnClose()
public boolean isStreamDisposedOnClose()
يحصل على قيمة تشير إلى ما إذا كان هذا الدفق يتم التخلص منه عند الإغلاق.
القيمة: true إذا تم التخلص من الدفق عند الإغلاق؛ وإلا false.
Returns: boolean
getLength()
public long getLength()
يحصل أو يعيّن طول الدفق بالبايت. هذه القيمة أقل من Stream#getLength().getLength() بمقدار موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer.
القيمة: طول الدفق.
Returns: long
setLength(long value)
public void setLength(long value)
يحصل أو يعيّن طول الدفق بالبايت. هذه القيمة أقل من Stream#getLength().getLength() بمقدار موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer.
القيمة: طول الدفق.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| value | long |
canRead()
public boolean canRead()
يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم القراءة.
القيمة: true إذا كان الدفق يدعم القراءة؛ وإلا false.
Returns: boolean
canSeek()
public boolean canSeek()
يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم السعي.
القيمة: true إذا كان الدفق يدعم التحريك؛ وإلا false.
Returns: boolean
canWrite()
public boolean canWrite()
يحصل على قيمة تشير إلى ما إذا كان الدفق يدعم الكتابة.
القيمة: true إذا كان الدفق يدعم الكتابة؛ وإلا false.
Returns: boolean
flush()
public void flush()
يمسح جميع المخازن المؤقتة لهذا الدفق ويتسبب في كتابة أي بيانات مخزنة مؤقتًا إلى الجهاز الأساسي.
write(byte[] bytes)
public void write(byte[] bytes)
يكتب جميع البايتات المحددة إلى الدفق.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| بايتات | byte[] | البايتات للكتابة. |
writeByte(byte value)
public void writeByte(byte value)
يكتب بايتًا إلى الموضع الحالي في الدفق ويُقدم الموضع داخل الدفق بايتًا واحدًا.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| value | byte | البايت للكتابة إلى الدفق. |
read(byte[] bytes)
public int read(byte[] bytes)
يقرأ البايتات لملء المخزن المؤقت للبايتات المحدد.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| بايتات | byte[] | البايتات للتعبئة. |
Returns: int - عدد البايتات المقروءة. قد تكون هذه القيمة أقل من عدد البايتات في المخزن المؤقت إذا لم يكن هناك ما يكفي من البايتات في الدفق.
toBytes()
public byte[] toBytes()
يحوّل بيانات الدفق إلى مصفوفة byte.
Returns:
byte[] - بيانات الدفق محوّلة إلى مصفوفة byte.
toBytes(long position, long bytesCount)
public byte[] toBytes(long position, long bytesCount)
يحوّل بيانات الدفق إلى مصفوفة byte.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| position | long | الموضع لبدء قراءة البايتات منه. |
| bytesCount | long | عدد البايتات للقراءة. |
Returns:
byte[] - بيانات الدفق محوّلة إلى مصفوفة byte.
read(byte[] buffer, int offset, int count)
public int read(byte[] buffer, int offset, int count)
يقرأ تسلسلًا من البايتات من الدفق الحالي ويقدّم الموضع داخل الدفق بعدد البايتات المقروءة.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| buffer | byte[] | مصفوفة من البايتات. عند عودة هذه الطريقة، يحتوي الـ buffer على مصفوفة البايتات المحددة مع القيم بين offset و (offset + count - 1) المستبدلة بالبايتات المقروءة من المصدر الحالي. |
| offset | int | الإزاحة الصفرية للبايت في buffer التي يبدأ عندها تخزين البيانات المقروءة من الدفق الحالي. |
| count | int | الحد الأقصى لعدد البايتات التي سيتم قراءتها من الدفق الحالي. |
Returns: int - إجمالي عدد البايتات المقروءة إلى المخزن المؤقت. قد يكون هذا أقل من عدد البايتات المطلوبة إذا لم تتوفر تلك البايتات حاليًا، أو صفر (0) إذا تم الوصول إلى نهاية الدفق.
readByte()
public int readByte()
يقرأ بايتًا من الدفق ويقدّم الموضع داخل الدفق بايتًا واحدًا، أو يُعيد -1 إذا كان عند نهاية الدفق.
Returns: int - البايت غير الموقع محوّل إلى Int32، أو -1 إذا كان عند نهاية الدفق.
seek(long offset, int origin)
public long seek(long offset, int origin)
يضبط الموضع داخل الدفق الحالي.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| offset | long | إزاحة بايت نسبية إلى المعامل origin. تمثل هذه القيمة الإزاحة من موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer. |
| origin | int | قيمة من النوع System.IO.SeekOrigin تشير إلى نقطة المرجع المستخدمة للحصول على الموضع الجديد. |
Returns: long - الموضع الجديد داخل الدفق الحالي.
seekBegin()
public void seekBegin()
يضبط موضع الدفق إلى بداية الدفق. تمثل هذه القيمة الإزاحة من موضع بدء الدفق الذي تم تمريره في مُنشئ StreamContainer.
write(byte[] buffer, int offset, int count)
public void write(byte[] buffer, int offset, int count)
يكتب تسلسلًا من البايتات إلى الدفق الحالي ويقدّم الموضع الحالي داخل هذا الدفق بعدد البايتات المكتوبة.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| buffer | byte[] | مصفوفة من البايتات. تنسخ هذه الطريقة count بايت من buffer إلى الدفق الحالي. |
| offset | int | الإزاحة الصفرية للبايت في buffer التي يبدأ عندها نسخ البايتات إلى الدفق الحالي. |
| count | int | عدد البايتات التي سيتم كتابتها إلى الدفق الحالي. |
save(OutputStream destinationStream)
public void save(OutputStream destinationStream)
يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. يستخدم حجم المخزن المؤقت الافتراضي ReadWriteBytesCount وقيمة الدفق Length.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| destinationStream | java.io.OutputStream | الدفق لحفظ البيانات إليه. |
save(OutputStream destinationStream, int bufferSize)
public void save(OutputStream destinationStream, int bufferSize)
يحفظ (ينسخ) جميع بيانات الدفق إلى الدفق المحدد. يستخدم قيمة الدفق Length.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| destinationStream | java.io.OutputStream | الدفق لحفظ البيانات إليه. |
| bufferSize | int | المخزن المؤقت. |
save(OutputStream destinationStream, int bufferSize, long length)
public void save(OutputStream destinationStream, int bufferSize, long length)
يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| destinationStream | java.io.OutputStream | الدفق لحفظ البيانات إليه. |
| bufferSize | int | حجم المخزن المؤقت. يتم استخدام القيمة الافتراضية ReadWriteBytesCount. |
| length | long | طول بيانات الدفق للنسخ. بشكل افتراضي، يتم تعيين الطول إلى قيمة Length. |
save(String filePath)
public void save(String filePath)
يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. يستخدم حجم المخزن المؤقت الافتراضي ReadWriteBytesCount وقيمة الدفق Length.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| filePath | java.lang.String | مسار الملف لحفظ بيانات الدفق إليه. |
save(String filePath, int bufferSize)
public void save(String filePath, int bufferSize)
يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد. يستخدم قيمة الدفق Length.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| filePath | java.lang.String | مسار الملف لحفظ بيانات الدفق إليه. |
| bufferSize | int | حجم المخزن المؤقت. يتم استخدام القيمة الافتراضية ReadWriteBytesCount. |
save(String filePath, int bufferSize, long length)
public void save(String filePath, int bufferSize, long length)
يحفظ (ينسخ) بيانات الدفق إلى الدفق المحدد.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| filePath | java.lang.String | مسار الملف لحفظ بيانات الدفق إليه. |
| bufferSize | int | حجم المخزن المؤقت. يتم استخدام القيمة الافتراضية ReadWriteBytesCount. |
| length | long | طول بيانات الدفق للنسخ. بشكل افتراضي، يتم تعيين الطول إلى قيمة Length. |
writeTo(StreamContainer streamContainer)
public void writeTo(StreamContainer streamContainer)
ينسخ البيانات المحتواة إلى StreamContainer آخر.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| streamContainer | StreamContainer | حاوية الدفق للنسخ إليها. |
writeTo(StreamContainer streamContainer, long length)
public void writeTo(StreamContainer streamContainer, long length)
ينسخ البيانات المحتواة إلى StreamContainer آخر.
Parameters:
| معامل | نوع | الوصف |
|---|---|---|
| streamContainer | StreamContainer | حاوية الدفق للنسخ إليها. |
| length | long | عدد البايتات للكتابة. |
