FileStream.Position-Eigenschaft

Artikel
08/20/2007

Ruft die aktuelle Position dieses Streams ab oder legt diese fest.

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

Syntax

'Declaration
Public Overrides Property Position As Long
'Usage
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)

Eigenschaftenwert

Die aktuelle Position dieses Streams.

Ausnahmen

Ausnahmetyp	Bedingung
NotSupportedException	Der Stream unterstützt keine Suchvorgänge.
IOException	Ein E/A-Fehler tritt auf. – oder – In Windows 98 oder früher wurde die Position auf einen sehr großen Wert nach dem Ende des Streams festgelegt.
ArgumentOutOfRangeException	Es wurde versucht, die Position auf einen negativen Wert festzulegen.
EndOfStreamException	Es wurde versucht, eine Suche über ein Ende eines Streams hinaus auszuführen, der diesen Vorgang nicht unterstützt.

Hinweise

Suchvorgänge an Positionen über die Länge des Streams hinaus werden unterstützt. Wenn Sie jenseits der Länge der Datei suchen, wird die Datei größer. In Microsoft Windows NT und neueren Betriebssystemen werden am Ende der Datei hinzugefügte Daten auf 0 (null) festgelegt. In Microsoft Windows 98 oder früher werden am Ende der Datei hinzugefügte Daten nicht auf 0 (null) festgelegt. Dies bedeutet, dass zuvor gelöschte Daten im Stream sichtbar sind. Wenn in Windows 98 oder früher die Position auf einen großen Wert nach dem Ende des Streams festgelegt wurde, wird möglicherweise eine Ausnahme ausgelöst.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Erstellen einer Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
In eine Textdatei schreiben.	Gewusst wie: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	Gewusst wie: Lesen aus einer Textdatei
Text an eine Datei anfügen.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Eine Datei kopieren.	File.Copy FileInfo.CopyTo
Die Größe eines Verzeichnisses abrufen.	FileInfo.Length
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Ein Unterverzeichnis erstellen.	CreateSubdirectory
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
In eine Binärdatei schreiben.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Die Dateien in einem Verzeichnis anzeigen.	Name
Die Dateien in einem Verzeichnis nach Größe sortieren.	GetFileSystemInfos

Beispiel

Im folgenden Beispiel wird mithilfe der Length-Eigenschaft und der Position-Eigenschaft überprüft, ob das Dateiende erreicht ist.

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.");

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

FileStream-Klasse
FileStream-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über