FileStream.Position 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

取得或設定這個資料流的目前位置。

public:
 virtual property long Position { long get(); void set(long value); };

public override long Position { get; set; }

member this.Position : int64 with get, set

Public Overrides Property Position As Long

Int64

這個資料流的目前位置。

資料流不支援搜尋。

IOException

發生 I/O 錯誤。

嘗試將位置設為負數值。

嘗試搜尋超過資料流的結尾，但不支援此作業。

下列範例會使用 Length 和 Position 屬性來檢查檔尾條件。

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.Length = s.Position then
    printfn "End of file has been reached."

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

支援搜尋超過數據流長度的任何位置。當您搜尋超過檔案的長度時，檔案大小會成長。新增至檔案結尾的任何數據都設定為零。

如需一般檔案和目錄作業的清單，請參閱一般 I/O 工作。

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0