FileStream.Position 属性
获取或设置此流的当前位置。
**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）
语法
声明
Public Overrides Property Position As Long
用法
Dim instance As FileStream
Dim value As Long
value = instance.Position
instance.Position = value
public override long Position { get; set; }
public:
virtual property long long Position {
long long get () override;
void set (long long value) override;
}
/** @property */
public long get_Position ()
/** @property */
public void set_Position (long value)
public override function get Position () : long
public override function set Position (value : long)
属性值
此流的当前位置。
异常
| 异常类型 | 条件 |
|---|---|
流不支持查找。 |
|
发生 I/O 错误。 - 或 - 在 Windows 98 或较早版本中，该位置被设置为超出流的末尾的很大的一个值。 |
|
试图将位置设置为负值。 |
|
试图在流的末尾之外查找，而流不支持此操作。 |
备注
支持搜索到超出流长度的任何位置。当在文件的长度之外查找时，文件的大小会增加。在 Microsoft Windows NT 和较新版本中，所有添加到文件末尾的数据都被设置为零。在 Microsoft Windows 98 或较早版本中，所有添加到文件末尾的数据都不会被设置为零，这意味着先前删除的数据对该流而言为可见。在 Windows 98 或较早版本中，如果将流的位置设置为超出流的末尾的很大的一个值，可能导致引发异常。
下表列出了其他典型或相关的 I/O 任务的示例。
若要执行此操作... |
请参见本主题中的示例... |
|---|---|
创建文本文件。 |
|
写入文本文件。 |
|
读取文本文件。 |
|
向文件中追加文本。 |
|
重命名或移动文件。 |
|
复制文件。 |
|
获取目录的大小。 |
|
获取文件属性。 |
|
设置文件属性。 |
|
创建子目录。 |
|
读取二进制文件。 |
|
写入二进制文件。 |
|
查看目录中的文件。 |
|
按大小对目录中的文件排序。 |
示例
下面的示例使用 Length 和 Position 属性检查文件尾条件。
If s.Length = s.Position Then
Console.WriteLine("End of file has been reached.")
End If
if( s.Length==s.Position )
{
Console.WriteLine("End of file has been reached.");
}
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.");
}
if( s.Length==s.Position )
Console.WriteLine("End of file has been reached.");
平台
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
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
.NET Compact Framework
受以下版本支持：2.0、1.0
请参见
参考
FileStream 类
FileStream 成员
System.IO 命名空间