0 out of 4 rated this helpful - Rate this topic

FileStream.Length Property

.NET Framework 2.0

Gets the length in bytes of the stream.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

public override long Length { get; }

/** @property */
public long get_Length ()

JScript

public override function get Length () : long

Property Value

A long value representing the length of the stream in bytes.

Exceptions

Exception type	Condition
NotSupportedException	CanSeek for this stream is false.
IOException	An I/O error occurs, such as the file being closed.

Remarks

The following table lists examples of other typical or related I/O tasks.

To do this...	See the example in this topic...
Create a text file.	How to: Write Text to a File
Write to a text file.	How to: Write Text to a File
Read from a text file.	How to: Read Text from a File
Append text to a file.	How to: Open and Append to a Log File File.AppendText FileInfo.AppendText
Rename or move a file.	File.Move FileInfo.MoveTo
Copy a file.	File.Copy FileInfo.CopyTo
Get the size of a directory.	FileInfo.Length
Get the attributes of a file.	File.GetAttributes
Set the attributes of a file.	File.SetAttributes
Create a subdirectory.	CreateSubdirectory
Read from a binary file.	How to: Read and Write to a Newly Created Data File
Write to a binary file.	How to: Read and Write to a Newly Created Data File
See the files in a directory.	Name
Sort files in a directory by size.	GetFileSystemInfos

Example

The following example uses the Length and Position properties to check for an end-of-file condition.

C++

if( s.Length==s.Position )
{
   Console.WriteLine("End of file has been reached.");
}

if (s.get_Length() == s.get_Position()) {
    Console.WriteLine("End of file has been reached.");
}

JScript

if( s.Length==s.Position )
    Console.WriteLine("End of file has been reached.");

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

FileStream Class
FileStream Members
System.IO Namespace

Other Resources

File and Stream I/O
How to: Read Text from a File
How to: Write Text to a File

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD