FileStream.Position Свойство

Определение

Возвращает или задает текущую позицию этого потока.Gets or sets the current position of this stream.

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

Текущая позиция потока.The current position of this stream.

Исключения

Поток не поддерживает поиск.The stream does not support seeking.

Ошибка ввода/вывода.An I/O error occurred.

-или--or-

Для положения задано очень большое значение за пределами конца потока в Windows 98 или более ранней версии.The position was set to a very large value beyond the end of the stream in Windows 98 or earlier.

Попытка установить для положения отрицательное значение.Attempted to set the position to a negative value.

Попытка поиска за пределами потока, который не поддерживает это.Attempted seeking past the end of a stream that does not support this.

Примеры

В следующем примере для Length Position проверки условия конца файла используются свойства и.The following example uses the Length and Position properties to check for an end-of-file condition.

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
    Console.WriteLine("End of file has been reached.")
End If

Комментарии

Поддерживается поиск в любом расположении, превышающем длину потока.Seeking to any location beyond the length of the stream is supported. При поиске за пределами размера файла Размер файла увеличивается.When you seek beyond the length of the file, the file size grows. В Microsoft Windows NT и более поздних версиях для всех данных, добавляемых в конец файла, устанавливается нулевое значение.In Microsoft Windows NT and newer, any data added to the end of the file is set to zero. В Microsoft Windows 98 или более ранней версии любые данные, добавленные в конец файла, не равны нулю. Это означает, что ранее удаленные данные видимы для потока.In Microsoft Windows 98 or earlier, any data added to the end of the file is not set to zero, which means that previously deleted data is visible to the stream. Установка в качестве позиции потока большого значения за пределами конца потока в Windows 98 или более ранней версии может привести к возникновению исключения.Setting the position of the stream to a large value beyond the end of the stream in Windows 98 or earlier may result in an exception being raised.

Список общих операций с файлами и каталогами см. в разделе Общие задачи ввода-вывода.For a list of common file and directory operations, see Common I/O Tasks.

Применяется к

См. также раздел