Действительно ли FileStream.SafeFileHandle * действительно устанавливает текущую позицию потока в 0?

Question

Согласно MSDN documentation for FileStream.SafeFileHandle:

SafeFileHandle свойство автоматически очищает поток и устанавливает текущую позицию потока в 0. Это позволяет файл будет перемещен или положение потока, чтобы сбросить другой поток, используя SafeFileHandle возвращается этим свойством.

Однако, мои тесты, кажется, указывают, что позиция поток не изменилось.

Рассмотрим следующий код:

using System; 
using System.IO; 

namespace Demo 
{ 
    internal static class Program 
    { 
     public static void Main() 
     { 
      Directory.CreateDirectory("C:\\TEST"); 
      var buffer = new byte[1024]; 

      using (var file = new FileStream("C:\\TEST\\TEST.BIN", FileMode.Create)) 
      { 
       file.Write(buffer, 0, buffer.Length); 
       Console.WriteLine(file.Position); // Prints 1024 
       var dummy = file.SafeFileHandle; 
       // dummy.Dispose();    // Uncommenting this line will make the next line throw. 
       Console.WriteLine(file.Position); // Still prints 1024! 
      } 
     } 
    } 
} 

Если доступ SafeFileHandle действительно сбросить текущую позицию потока до 0, я бы ожидал, что второй WriteLine() для печати 0.

У меня есть другие где я на самом деле использую SafeFileHandle с методами чтения Windows API ReadFile() и WriteFile(), и даже тогда он не изменит указатель на файл.

У меня есть код, который использует SafeFileHandle, поэтому для меня очень важно, будет ли изменено положение потока или нет!

Я неправильно понял документацию, или она неверна? Или он меняет положение потока иногда? (Это был бы кошмар!)

Answer 1

Я думаю, что документация фактически говорит о входных и выходных буферах, используемых FileStream ("FileStream buffers input and output for better performance.").

Если используются эталонным источник библиотеки .NET, вы можете увидеть, что SafeFileHandle свойства фактически сбрасывает все буфера (то есть кэша) и сбрасывает их позиции обратно к нулю. Он не касается переменной, которая содержит информацию о том, как далеко файл действительно был прочитан (или написан). Свойство Position, в свою очередь, всегда использует эту переменную (плюс смещения буфера/кеша), чтобы вернуть ее значение.

важная часть, как представляется, это:

Это позволяет файл будет перемещен или положение потока будет переназначен другой поток, используя SafeFileHandle возвращаемый этим свойством.

В принципе, SafeFileHandle гарантирует вам, что вы можете использовать возвращаемое значение (например, с SetFilePointer), чтобы получить доступ к файлу, и никаких проблем с (в конечном счете) кэширования экземпляра FileStream.