MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) Method

定義

現在のストリーム長を指定した値に設定します。Sets the length of the current stream to the specified value.

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public Overrides Sub SetLength (value As Long)

パラメーター

value
Int64 Int64 Int64 Int64

長さを設定する値。The value at which to set the length.

例外

現在のストリームのサイズが変更できません。value が現在の容量を超えています。The current stream is not resizable and value is larger than the current capacity.

または-or- 現在のストリームが書き込みをサポートしません。The current stream does not support writing.

value が負または MemoryStream の最大長より大きな値です。最大長は、(MaxValue - origin) で計算され、origin は、ストリームが開始する位置を示す基になるバッファーのインデックスです。value is negative or is greater than the maximum length of the MemoryStream, where the maximum length is(MaxValue - origin), and origin is the index into the underlying buffer at which the stream starts.

注釈

このメソッドは、SetLength をオーバーライドします。This method overrides SetLength.

指定した値がストリームの現在の長さより小さい場合は、ストリームは切り捨てられます。If the specified value is less than the current length of the stream, the stream is truncated. ストリーム内の現在位置がストリームの末尾が切り捨て後の場合、ReadByteメソッドは-1 を返し、Readメソッドは、指定されたバイト配列に 0 バイトを読み取りますとWriteWriteByteメソッドの追加その長さを増やすと、ストリームの末尾に指定したバイト数。If after the truncation the current position within the stream is past the end of the stream, the ReadByte method returns -1, the Read method reads zero bytes into the provided byte array, and Write and WriteByte methods append specified bytes at the end of the stream, increasing its length. 指定した値が、現在の容量を超えるストリームがサイズ変更可能な場合は、容量が増加し、ストリーム内の現在の位置は変更されません。If the specified value is larger than the current capacity and the stream is resizable, the capacity is increased, and the current position within the stream is unchanged. 長さが大きくなった場合、古いと、新しい長さのストリームの内容はゼロに初期化されます。If the length is increased, the contents of the stream between the old and the new length are initialized to zeros.

注意

AMemoryStreamインスタンスは、このメソッドを使用する書き込みをサポートする必要があります。A MemoryStream instance must support writing for this method to work. 使用して、CanWriteプロパティを現在のインスタンスが書き込みをサポートするかどうかを判断します。Use the CanWrite property to determine whether the current instance supports writing. 詳細については、「CanWrite」を参照してください。For additional information, see CanWrite.

適用対象

こちらもご覧ください