FileStream Třída

Definice

Poskytuje Stream soubor, který podporuje synchronní i asynchronní operace čtení i zápisu.Provides a Stream for a file, supporting both synchronous and asynchronous read and write operations.

public ref class FileStream : System::IO::Stream
public class FileStream : System.IO.Stream
[System.Runtime.InteropServices.ComVisible(true)]
public class FileStream : System.IO.Stream
type FileStream = class
    inherit Stream
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileStream = class
    inherit Stream
Public Class FileStream
Inherits Stream
Dědičnost
FileStream
Dědičnost
Odvozené
Atributy

Příklady

Následující příklad ukazuje některé FileStream konstruktory.The following example demonstrates some of the FileStream constructors.

using namespace System;
using namespace System::IO;
using namespace System::Text;

void AddText( FileStream^ fs, String^ value )
{
   array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( value );
   fs->Write( info, 0, info->Length );
}

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Delete the file if it exists.
   if ( File::Exists( path ) )
   {
      File::Delete( path );
   }

   //Create the file.
   {
      FileStream^ fs = File::Create( path );
      try
      {
         AddText( fs, "This is some text" );
         AddText( fs, "This is some more text," );
         AddText( fs, "\r\nand this is on a new line" );
         AddText( fs, "\r\n\r\nThe following is a subset of characters:\r\n" );
         for ( int i = 1; i < 120; i++ )
         {
            AddText( fs, Convert::ToChar( i ).ToString() );
            
            //Split the output at every 10th character.
            if ( Math::IEEERemainder( Convert::ToDouble( i ), 10 ) == 0 )
            {
               AddText( fs, "\r\n" );
            }
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
   
   //Open the stream and read it back.
   {
      FileStream^ fs = File::OpenRead( path );
      try
      {
         array<Byte>^b = gcnew array<Byte>(1024);
         UTF8Encoding^ temp = gcnew UTF8Encoding( true );
         while ( fs->Read( b, 0, b->Length ) > 0 )
         {
            Console::WriteLine( temp->GetString( b ) );
         }
      }
      finally
      {
         if ( fs )
            delete (IDisposable^)fs;
      }
   }
}
using System;
using System.IO;
using System.Text;

class Test
{

    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(path))
        {
            File.Delete(path);
        }

        //Create the file.
        using (FileStream fs = File.Create(path))
        {
            AddText(fs, "This is some text");
            AddText(fs, "This is some more text,");
            AddText(fs, "\r\nand this is on a new line");
            AddText(fs, "\r\n\r\nThe following is a subset of characters:\r\n");

            for (int i=1;i < 120;i++)
            {
                AddText(fs, Convert.ToChar(i).ToString());
            }
        }

        //Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }

    private static void AddText(FileStream fs, string value)
    {
        byte[] info = new UTF8Encoding(true).GetBytes(value);
        fs.Write(info, 0, info.Length);
    }
}
Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Delete the file if it exists.
        If File.Exists(path) Then
            File.Delete(path)
        End If

        'Create the file.
        Dim fs As FileStream = File.Create(path)

        AddText(fs, "This is some text")
        AddText(fs, "This is some more text,")
        AddText(fs, Environment.NewLine & "and this is on a new line")
        AddText(fs, Environment.NewLine & Environment.NewLine)
        AddText(fs, "The following is a subset of characters:" & Environment.NewLine)

        Dim i As Integer

        For i = 1 To 120
            AddText(fs, Convert.ToChar(i).ToString())

        Next

        fs.Close()

        'Open the stream and read it back.
        fs = File.OpenRead(path)
        Dim b(1023) As Byte
        Dim temp As UTF8Encoding = New UTF8Encoding(True)

        Do While fs.Read(b, 0, b.Length) > 0
            Console.WriteLine(temp.GetString(b))
        Loop

        fs.Close()
    End Sub

    Private Shared Sub AddText(ByVal fs As FileStream, ByVal value As String)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes(value)
        fs.Write(info, 0, info.Length)
    End Sub
End Class

Následující příklad ukazuje, jak zapisovat do souboru asynchronně.The following example shows how to write to a file asynchronously. Tento kód je spuštěn v aplikaci WPF, která má TextBlock s názvem UserInput a tlačítko se připojila k obslužné rutině události Click s názvem Button_Click.This code runs in a WPF app that has a TextBlock named UserInput and a button hooked up to a Click event handler that is named Button_Click. Cesta k souboru musí být změněna na soubor, který se nachází v počítači.The file path needs to be changed to a file that exists on the computer.

using System;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.IO;

namespace WpfApplication1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            UnicodeEncoding uniencoding = new UnicodeEncoding();
            string filename = @"c:\Users\exampleuser\Documents\userinputlog.txt";

            byte[] result = uniencoding.GetBytes(UserInput.Text);

            using (FileStream SourceStream = File.Open(filename, FileMode.OpenOrCreate))
            {
                SourceStream.Seek(0, SeekOrigin.End);
                await SourceStream.WriteAsync(result, 0, result.Length);
            }
        }
    }
}
Imports System.IO
Imports System.Text

Class MainWindow
    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim uniencoding As UnicodeEncoding = New UnicodeEncoding()
        Dim filename As String = "c:\Users\exampleuser\Documents\userinputlog.txt"

        Dim result As Byte() = uniencoding.GetBytes(UserInput.Text)

        Using SourceStream As FileStream = File.Open(filename, FileMode.OpenOrCreate)
            SourceStream.Seek(0, SeekOrigin.End)
            Await SourceStream.WriteAsync(result, 0, result.Length)
        End Using
    End Sub
End Class

Poznámky

Použijte FileStream třídu pro čtení, zápis do, otevírání a zavírání souborů v systému souborů a k manipulaci s dalšími popisovači operačního systému souvisejícím se soubory, včetně kanálů, standardního vstupu a standardního výstupu.Use the FileStream class to read from, write to, open, and close files on a file system, and to manipulate other file-related operating system handles, including pipes, standard input, and standard output. Můžete použít Read Write metody,, a CopyTo Flush k provádění synchronních operací nebo ReadAsync WriteAsync metod,, CopyToAsync a FlushAsync k provádění asynchronních operací.You can use the Read, Write, CopyTo, and Flush methods to perform synchronous operations, or the ReadAsync, WriteAsync, CopyToAsync, and FlushAsync methods to perform asynchronous operations. Použijte asynchronní metody k provádění operací se soubory náročnými na prostředky bez blokování hlavního vlákna.Use the asynchronous methods to perform resource-intensive file operations without blocking the main thread. Toto posouzení výkonu je důležité především v případě aplikací pro Windows 8.x StoreWindows 8.x Store nebo klasické pracovní plochydesktop, kde časově náročná operace může zablokovat vlákno uživatelského rozhraní a aplikace se pak jeví jako nefunkční.This performance consideration is particularly important in a Windows 8.x StoreWindows 8.x Store app or klasické pracovní plochydesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. FileStream ukládá do vyrovnávací paměti vstup a výstup pro lepší výkon.FileStream buffers input and output for better performance.

Důležité

Tento typ implementuje IDisposable rozhraní.This type implements the IDisposable interface. Po dokončení používání typu byste ho měli nakládat buď přímo, nebo nepřímo.When you have finished using the type, you should dispose of it either directly or indirectly. Chcete-li přímo uvolnit typ, zavolejte jeho Dispose metodu v try / catch bloku.To dispose of the type directly, call its Dispose method in a try/catch block. Chcete-li ji nakládat nepřímo, použijte konstrukci jazyka, například using (v jazyce C#) nebo Using (v Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Další informace naleznete v části "použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

IsAsyncVlastnost zjistí, zda byl popisovač souboru otevřen asynchronně.The IsAsync property detects whether the file handle was opened asynchronously. Tuto hodnotu zadáte při vytváření instance FileStream třídy pomocí konstruktoru, který má isAsync useAsync parametr, nebo options .You specify this value when you create an instance of the FileStream class using a constructor that has an isAsync, useAsync, or options parameter. Pokud je vlastnost true , Stream využívá Překrývající vstupně-výstupní operace k asynchronnímu provádění operací se soubory.When the property is true, the stream utilizes overlapped I/O to perform file operations asynchronously. Vlastnost však nemusí IsAsync být true volána pro volání ReadAsync WriteAsync metody, nebo CopyToAsync .However, the IsAsync property does not have to be true to call the ReadAsync, WriteAsync, or CopyToAsync method. Pokud IsAsync je vlastnost false a voláte asynchronní operace čtení a zápisu, vlákno uživatelského rozhraní není blokováno, ale skutečná vstupně-výstupní operace je provedena synchronně.When the IsAsync property is false and you call the asynchronous read and write operations, the UI thread is still not blocked, but the actual I/O operation is performed synchronously.

SeekMetoda podporuje náhodný přístup k souborům.The Seek method supports random access to files. Seek umožňuje přesunout pozici pro čtení/zápis na jakoukoli pozici v rámci souboru.Seek allows the read/write position to be moved to any position within the file. To se provádí s parametry referenčního bodu posunu bajtů.This is done with byte offset reference point parameters. Posun bajtů je relativní vzhledem k referenčnímu bodu hledání, který může být začátek, aktuální pozice nebo konec podkladového souboru, jak je znázorněno v třech členech SeekOrigin výčtu.The byte offset is relative to the seek reference point, which can be the beginning, the current position, or the end of the underlying file, as represented by the three members of the SeekOrigin enumeration.

Poznámka

Soubory na disku vždycky podporují náhodný přístup.Disk files always support random access. V době konstrukce CanSeek je hodnota vlastnosti nastavena na true nebo false v závislosti na základním typu souboru.At the time of construction, the CanSeek property value is set to true or false depending on the underlying file type. Pokud je základní typ souboru FILE_TYPE_DISK, jak je definováno v Winbase. h, CanSeek hodnota vlastnosti je true .If the underlying file type is FILE_TYPE_DISK, as defined in winbase.h, the CanSeek property value is true. V opačném případě CanSeek je hodnota vlastnosti false .Otherwise, the CanSeek property value is false.

Pokud se proces ukončí se součástí souboru jako uzamčený nebo zavře soubor, který obsahuje nedokončené zámky, chování není definováno.If a process terminates with part of a file locked or closes a file that has outstanding locks, the behavior is undefined.

Operace s adresáři a další souborové operace naleznete v tématu File Directory třídy, a Path .For directory operations and other file operations, see the File, Directory, and Path classes. FileTřída je třída nástroje, která má primárně statické metody pro vytváření FileStream objektů na základě cest k souborům.The File class is a utility class that has static methods primarily for the creation of FileStream objects based on file paths. MemoryStreamTřída vytvoří datový proud z pole bajtů a je podobný FileStream třídě.The MemoryStream class creates a stream from a byte array and is similar to the FileStream class.

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.For a list of common file and directory operations, see Common I/O Tasks.

Zjišťování změn umístění datového prouduDetection of Stream Position Changes

Pokud FileStream objekt nemá exkluzivní blokování na jeho popisovači, může jiné vlákno přistupovat k popisovači souborů souběžně a změnit umístění ukazatele souboru v operačním systému, který je přidružen k popisovači souboru.When a FileStream object does not have an exclusive hold on its handle, another thread could access the file handle concurrently and change the position of the operating system's file pointer that is associated with the file handle. V takovém případě může dojít k narušení umístění v mezipaměti v FileStream objektu a dat uložených v mezipaměti ve vyrovnávací paměti.In this case, the cached position in the FileStream object and the cached data in the buffer could be compromised. FileStreamObjekt rutinně provádí kontroly metod, které přistupují do vyrovnávací paměti mezipaměti, aby bylo zajištěno, že pozice popisovače operačního systému je stejná jako umístění v mezipaměti, které je používáno FileStream objektem.The FileStream object routinely performs checks on methods that access the cached buffer to ensure that the operating system's handle position is the same as the cached position used by the FileStream object.

Pokud je zjištěna neočekávaná Změna pozice popisovače při volání Read metody, .NET Framework zahodí obsah vyrovnávací paměti a přečte datový proud ze souboru znovu.If an unexpected change in the handle position is detected in a call to the Read method, the .NET Framework discards the contents of the buffer and reads the stream from the file again. To může mít vliv na výkon v závislosti na velikosti souboru a dalších procesech, které by mohly ovlivnit pozici datového proudu souboru.This can affect performance, depending on the size of the file and any other processes that could affect the position of the file stream.

Pokud je zjištěna neočekávaná Změna pozice popisovače při volání Write metody, obsah vyrovnávací paměti je zahozen a IOException je vyvolána výjimka.If an unexpected change in the handle position is detected in a call to the Write method, the contents of the buffer are discarded and an IOException exception is thrown.

FileStreamObjekt nebude mít výhradní blokování v popisovači, je-li k dispozici buď SafeFileHandle vlastnost k vystavení popisovače, nebo je-li FileStream objekt SafeFileHandle v jeho konstruktoru vlastnost udělena.A FileStream object will not have an exclusive hold on its handle when either the SafeFileHandle property is accessed to expose the handle or the FileStream object is given the SafeFileHandle property in its constructor.

Konstruktory

FileStream(IntPtr, FileAccess)
Zastaralé.
Zastaralé.
Zastaralé.

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním pro čtení a zápis.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(IntPtr, FileAccess, Boolean)
Zastaralé.
Zastaralé.
Zastaralé.

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení/zápisu a FileStream vlastnictví instance.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission and FileStream instance ownership.

FileStream(IntPtr, FileAccess, Boolean, Int32)
Zastaralé.
Zastaralé.
Zastaralé.

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení/zápisu, FileStream vlastnictví instance a velikosti vyrovnávací paměti.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, and buffer size.

FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)
Zastaralé.
Zastaralé.
Zastaralé.

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení/zápisu, FileStream vlastnictví instance, velikosti vyrovnávací paměti a synchronním nebo asynchronním stavu.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, buffer size, and synchronous or asynchronous state.

FileStream(SafeFileHandle, FileAccess)

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním pro čtení a zápis.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(SafeFileHandle, FileAccess, Int32)

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení/zápisu a velikosti vyrovnávací paměti.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, and buffer size.

FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení/zápisu, velikosti vyrovnávací paměti a synchronním nebo asynchronním stavem.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode)

Inicializuje novou instanci FileStream třídy se zadanou cestou a režimem vytváření.Initializes a new instance of the FileStream class with the specified path and creation mode.

FileStream(String, FileMode, FileAccess)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření a oprávněním pro čtení a zápis.Initializes a new instance of the FileStream class with the specified path, creation mode, and read/write permission.

FileStream(String, FileMode, FileAccess, FileShare)

Inicializuje novou instanci FileStream třídy se zadaným umístěním, režimem vytváření, oprávněním pro čtení a zápis a oprávněním ke sdílení.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write permission, and sharing permission.

FileStream(String, FileMode, FileAccess, FileShare, Int32)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávněním pro čtení a zápis a sdílení a velikostí vyrovnávací paměti.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, and buffer size.

FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávněním ke čtení/zápisu a sdílení, velikostí vyrovnávací paměti a synchronním nebo asynchronním stavem.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem pro čtení a zápis a sdílení, přístup k jiným datovým proudům může mít stejný soubor, velikost vyrovnávací paměti a další možnosti souborů.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, the access other FileStreams can have to the same file, the buffer size, and additional file options.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, přístupovými právy a oprávněními ke sdílení, velikostí vyrovnávací paměti a dalšími možnostmi souborů.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, and additional file options.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, přístupovými právy a oprávněními ke sdílení, velikostí vyrovnávací paměti, dalšími možnostmi souborů, řízením přístupu a zabezpečením auditu.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, additional file options, access control and audit security.

Vlastnosti

CanRead

Získá hodnotu, která označuje, zda aktuální datový proud podporuje čtení.Gets a value that indicates whether the current stream supports reading.

CanSeek

Získá hodnotu, která označuje, zda aktuální datový proud podporuje hledání.Gets a value that indicates whether the current stream supports seeking.

CanTimeout

Získá hodnotu, která určuje, zda aktuální datový proud může vyprší časový limit.Gets a value that determines whether the current stream can time out.

(Zděděno od Stream)
CanWrite

Získá hodnotu, která označuje, zda aktuální datový proud podporuje zápis.Gets a value that indicates whether the current stream supports writing.

Handle
Zastaralé.
Zastaralé.
Zastaralé.

Načte popisovač souboru operačního systému pro soubor, který je v aktuálním FileStream objektu zapouzdřený.Gets the operating system file handle for the file that the current FileStream object encapsulates.

IsAsync

Načte hodnotu, která indikuje, jestli se FileStream otevřela asynchronně nebo synchronně.Gets a value that indicates whether the FileStream was opened asynchronously or synchronously.

Length

Získá délku datového proudu v bajtech.Gets the length in bytes of the stream.

Name

Načte absolutní cestu k souboru otevřenému v FileStream .Gets the absolute path of the file opened in the FileStream.

Position

Získá nebo nastaví aktuální pozici tohoto datového proudu.Gets or sets the current position of this stream.

ReadTimeout

Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud před vypršením časového limitu pokusí přečíst.Gets or sets a value, in milliseconds, that determines how long the stream will attempt to read before timing out.

(Zděděno od Stream)
SafeFileHandle

Získá SafeFileHandle objekt, který představuje popisovač souboru operačního systému pro soubor, který je v aktuálním FileStream objektu zapouzdřený.Gets a SafeFileHandle object that represents the operating system file handle for the file that the current FileStream object encapsulates.

WriteTimeout

Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud před vypršením časového limitu pokusí zapisovat.Gets or sets a value, in milliseconds, that determines how long the stream will attempt to write before timing out.

(Zděděno od Stream)

Metody

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Zahájí asynchronní operaci čtení.Begins an asynchronous read operation. ReadAsync(Byte[], Int32, Int32, CancellationToken)Místo toho zvažte použití.Consider using ReadAsync(Byte[], Int32, Int32, CancellationToken) instead.

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Zahájí asynchronní operaci čtení.Begins an asynchronous read operation. ( ReadAsync(Byte[], Int32, Int32) Místo toho zvažte použití.)(Consider using ReadAsync(Byte[], Int32, Int32) instead.)

(Zděděno od Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Spustí asynchronní operaci zápisu.Begins an asynchronous write operation. WriteAsync(Byte[], Int32, Int32, CancellationToken)Místo toho zvažte použití.Consider using WriteAsync(Byte[], Int32, Int32, CancellationToken) instead.

BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Spustí asynchronní operaci zápisu.Begins an asynchronous write operation. ( WriteAsync(Byte[], Int32, Int32) Místo toho zvažte použití.)(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

(Zděděno od Stream)
Close()

Zavře aktuální datový proud a uvolní všechny prostředky (například sokety a popisovače souborů) přidružené k aktuálnímu datovému proudu.Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream.

Close()

Zavře aktuální datový proud a uvolní všechny prostředky (například sokety a popisovače souborů) přidružené k aktuálnímu datovému proudu.Closes the current stream and releases any resources (such as sockets and file handles) associated with the current stream. Místo volání této metody zajistěte, aby byl datový proud správně uvolněn.Instead of calling this method, ensure that the stream is properly disposed.

(Zděděno od Stream)
CopyTo(Stream)

Přečte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu.Reads the bytes from the current stream and writes them to another stream.

(Zděděno od Stream)
CopyTo(Stream, Int32)

Přečte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti.Reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

(Zděděno od Stream)
CopyToAsync(Stream)

Asynchronně načte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu.Asynchronously reads the bytes from the current stream and writes them to another stream.

(Zděděno od Stream)
CopyToAsync(Stream, CancellationToken)

Asynchronně načte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadaného tokenu zrušení.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified cancellation token.

(Zděděno od Stream)
CopyToAsync(Stream, Int32)

Asynchronně načte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size.

(Zděděno od Stream)
CopyToAsync(Stream, Int32, CancellationToken)

Asynchronně načte bajty z aktuálního streamu souborů a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti a tokenu zrušení.Asynchronously reads the bytes from the current file stream and writes them to another stream, using a specified buffer size and cancellation token.

CopyToAsync(Stream, Int32, CancellationToken)

Asynchronně načte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti a tokenu zrušení.Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.

(Zděděno od Stream)
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Zděděno od MarshalByRefObject)
CreateWaitHandle()
Zastaralé.

Přidělí WaitHandle objekt.Allocates a WaitHandle object.

(Zděděno od Stream)
Dispose()

Uvolní všechny prostředky, které používá Stream .Releases all resources used by the Stream.

(Zděděno od Stream)
Dispose(Boolean)

Uvolní nespravované prostředky používané FileStream a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the FileStream and optionally releases the managed resources.

DisposeAsync()

Asynchronně uvolňuje nespravované prostředky, které používá FileStream .Asynchronously releases the unmanaged resources used by the FileStream.

DisposeAsync()

Asynchronně uvolňuje nespravované prostředky, které používá Stream .Asynchronously releases the unmanaged resources used by the Stream.

(Zděděno od Stream)
EndRead(IAsyncResult)

Čeká na dokončení čekající operace asynchronního čtení.Waits for the pending asynchronous read operation to complete. ( ReadAsync(Byte[], Int32, Int32, CancellationToken) Místo toho zvažte použití.)(Consider using ReadAsync(Byte[], Int32, Int32, CancellationToken) instead.)

EndRead(IAsyncResult)

Čeká na dokončení probíhajícího asynchronního čtení.Waits for the pending asynchronous read to complete. ( ReadAsync(Byte[], Int32, Int32) Místo toho zvažte použití.)(Consider using ReadAsync(Byte[], Int32, Int32) instead.)

(Zděděno od Stream)
EndWrite(IAsyncResult)

Ukončí asynchronní operaci zápisu a zablokuje až do dokončení vstupně-výstupních operací.Ends an asynchronous write operation and blocks until the I/O operation is complete. ( WriteAsync(Byte[], Int32, Int32, CancellationToken) Místo toho zvažte použití.)(Consider using WriteAsync(Byte[], Int32, Int32, CancellationToken) instead.)

EndWrite(IAsyncResult)

Ukončí asynchronní operaci zápisu.Ends an asynchronous write operation. ( WriteAsync(Byte[], Int32, Int32) Místo toho zvažte použití.)(Consider using WriteAsync(Byte[], Int32, Int32) instead.)

(Zděděno od Stream)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
Finalize()

Zajišťuje, aby prostředky byly uvolněny a jiné operace čištění byly provedeny, když systém uvolňování paměti Redeklarace provede FileStream .Ensures that resources are freed and other cleanup operations are performed when the garbage collector reclaims the FileStream.

Flush()

Vymaže vyrovnávací paměti pro tento datový proud a způsobí, že se do souboru zapisují data do vyrovnávací paměti.Clears buffers for this stream and causes any buffered data to be written to the file.

Flush(Boolean)

Vymaže vyrovnávací paměti pro tento datový proud a způsobí, že se do souboru zapisují data do vyrovnávací paměti, a zároveň vymaže všechny mezilehlé vyrovnávací paměti souborů.Clears buffers for this stream and causes any buffered data to be written to the file, and also clears all intermediate file buffers.

FlushAsync()

Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud a způsobí, že všechna data uložená do vyrovnávací paměti se zapisují do základního zařízení.Asynchronously clears all buffers for this stream and causes any buffered data to be written to the underlying device.

(Zděděno od Stream)
FlushAsync(CancellationToken)

Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud, způsobí, že všechna data uložená do vyrovnávací paměti se zapisují do základního zařízení a monitorují žádosti o zrušení.Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.

FlushAsync(CancellationToken)

Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud, způsobí, že všechna data uložená do vyrovnávací paměti se zapisují do základního zařízení a monitorují žádosti o zrušení.Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.

(Zděděno od Stream)
GetAccessControl()

Získává FileSecurity objekt, který zapouzdřuje položky seznamu řízení přístupu (ACL) pro soubor popsaný aktuálním FileStream objektem.Gets a FileSecurity object that encapsulates the access control list (ACL) entries for the file described by the current FileStream object.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Zděděno od MarshalByRefObject)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

(Zděděno od MarshalByRefObject)
Lock(Int64, Int64)

Zabraňuje jiným procesům v čtení nebo zápisu do FileStream .Prevents other processes from reading from or writing to the FileStream.

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu bez podstruktury MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

(Zděděno od MarshalByRefObject)
ObjectInvariant()
Zastaralé.

Poskytuje podporu pro Contract .Provides support for a Contract.

(Zděděno od Stream)
Read(Byte[], Int32, Int32)

Přečte blok bajtů z datového proudu a zapíše data do dané vyrovnávací paměti.Reads a block of bytes from the stream and writes the data in a given buffer.

Read(Span<Byte>)

Přečte sekvenci bajtů z aktuálního streamu souborů a Posune pozici v rámci datového proudu souboru o počet přečtených bajtů.Reads a sequence of bytes from the current file stream and advances the position within the file stream by the number of bytes read.

Read(Span<Byte>)

Při přepsání v odvozené třídě přečte sekvenci bajtů z aktuálního datového proudu a Posune pozici v rámci datového proudu o počet přečtených bajtů.When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

(Zděděno od Stream)
ReadAsync(Byte[], Int32, Int32)

Asynchronně přečte sekvenci bajtů z aktuálního datového proudu a Posune pozici v rámci datového proudu o počet přečtených bajtů.Asynchronously reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.

(Zděděno od Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)

Asynchronně přečte sekvenci bajtů z aktuálního streamu souborů a zapisuje je do bajtového pole začínajícího zadaným posunutím, Posune pozici v rámci datového proudu pomocí počtu přečtených bajtů a monitoruje žádosti o zrušení.Asynchronously reads a sequence of bytes from the current file stream and writes them to a byte array beginning at a specified offset, advances the position within the file stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Byte[], Int32, Int32, CancellationToken)

Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, Posune pozici v rámci datového proudu o počet přečtených bajtů a monitoruje žádosti o zrušení.Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.

(Zděděno od Stream)
ReadAsync(Memory<Byte>, CancellationToken)

Asynchronně přečte sekvenci bajtů z aktuálního streamu souborů a zapisuje je do paměťové oblasti, Posune pozici v rámci datového proudu pomocí počtu přečtených bajtů a monitoruje žádosti o zrušení.Asynchronously reads a sequence of bytes from the current file stream and writes them to a memory region, advances the position within the file stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Memory<Byte>, CancellationToken)

Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, Posune pozici v rámci datového proudu o počet přečtených bajtů a monitoruje žádosti o zrušení.Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.

(Zděděno od Stream)
ReadByte()

Přečte bajt ze souboru a Posune pozici pro čtení o jeden bajt.Reads a byte from the file and advances the read position one byte.

Seek(Int64, SeekOrigin)

Nastaví aktuální pozici tohoto datového proudu na danou hodnotu.Sets the current position of this stream to the given value.

SetAccessControl(FileSecurity)

Použije položky seznamu řízení přístupu (ACL), které jsou popsány FileSecurity objektem, do souboru popsaných aktuálním FileStream objektem.Applies access control list (ACL) entries described by a FileSecurity object to the file described by the current FileStream object.

SetLength(Int64)

Nastaví délku tohoto datového proudu na danou hodnotu.Sets the length of this stream to the given value.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
Unlock(Int64, Int64)

Umožňuje přístup jiným procesům do souboru, který byl dříve uzamčen.Allows access by other processes to all or part of a file that was previously locked.

Write(Byte[], Int32, Int32)

Zapíše blok bajtů do datového proudu souboru.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>)

Zapíše posloupnost bajtů z rozsahu určeného jen ke čtení do aktuálního datového proudu souboru a Posune aktuální pozici v rámci tohoto datového proudu pomocí počtu zapsaných bajtů.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

Write(ReadOnlySpan<Byte>)

Při přepsání v odvozené třídě zapíše posloupnost bajtů do aktuálního datového proudu a Posune aktuální pozici v rámci tohoto datového proudu o počet zapsaných bajtů.When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

(Zděděno od Stream)
WriteAsync(Byte[], Int32, Int32)

Asynchronně zapisuje sekvenci bajtů do aktuálního datového proudu a Posune aktuální pozici v rámci tohoto datového proudu o počet zapsaných bajtů.Asynchronously writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

(Zděděno od Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Asynchronně zapisuje sekvenci bajtů k aktuálnímu datovému proudu, posune aktuální pozici v rámci tohoto datového proudu o počet zapsaných bajtů a monitoruje žádosti o zrušení.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Asynchronně zapisuje sekvenci bajtů k aktuálnímu datovému proudu, posune aktuální pozici v rámci tohoto datového proudu o počet zapsaných bajtů a monitoruje žádosti o zrušení.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

(Zděděno od Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Asynchronně zapisuje sekvenci bajtů z oblasti paměti do aktuálního streamu souborů, posune aktuální pozici v rámci tohoto datového proudu souboru o počet zapsaných bajtů a monitoruje žádosti o zrušení.Asynchronously writes a sequence of bytes from a memory region to the current file stream, advances the current position within this file stream by the number of bytes written, and monitors cancellation requests.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Asynchronně zapisuje sekvenci bajtů k aktuálnímu datovému proudu, posune aktuální pozici v rámci tohoto datového proudu o počet zapsaných bajtů a monitoruje žádosti o zrušení.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

(Zděděno od Stream)
WriteByte(Byte)

Zapíše bajt na aktuální pozici v datovém proudu souboru.Writes a byte to the current position in the file stream.

Explicitní implementace rozhraní

IDisposable.Dispose()

Uvolní všechny prostředky, které používá Stream .Releases all resources used by the Stream.

(Zděděno od Stream)

Metody rozšíření

GetAccessControl(FileStream)

Vrátí informace o zabezpečení souboru.Returns the security information of a file.

SetAccessControl(FileStream, FileSecurity)

Změní atributy zabezpečení stávajícího souboru.Changes the security attributes of an existing file.

AsInputStream(Stream)

Převede spravovaný datový proud v rozhraní .NET pro aplikace pro Windows Store na vstupní datový proud v prostředí Windows Runtime.Converts a managed stream in the .NET for Windows Store apps to an input stream in the Windows Runtime.

AsOutputStream(Stream)

Převede spravovaný datový proud v rozhraní .NET pro aplikace pro Windows Store na výstupní datový proud v prostředí Windows Runtime.Converts a managed stream in the .NET for Windows Store apps to an output stream in the Windows Runtime.

AsRandomAccessStream(Stream)

Převede zadaný datový proud na datový proud s náhodným přístupem.Converts the specified stream to a random access stream.

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce await u úloh vrácených z asynchronního použití.Configures how awaits on the tasks returned from an async disposable are performed.

Platí pro

Viz také