FileStream Konstruktory

Reference

Definice

Obor názvů:: System.IO

Sestavení:: mscorlib.dll, System.IO.FileSystem.dll

Sestavení:: System.Runtime.dll

Sestavení:: netstandard.dll

Sestavení:: System.IO.FileSystem.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci FileStream třídy.

Přetížení

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.
FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)	Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním pro přístupová práva a sdílení, velikost vyrovnávací paměti, další možnosti souborů, řízení přístupu a FileStream zabezpečení auditu.
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ů.
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ů.
FileStream(String, FileMode, FileAccess, FileShare, Int32)	Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním ke čtení a zápisu a sdílení a FileStream velikostí vyrovnávací paměti.
FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)	Zastaralé. Zastaralé. Zastaralé. Zastaralé. Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, vlastnictvím instance, velikostí vyrovnávací paměti a synchronním FileStream `FileStream` nebo asynchronním stavem.
FileStream(String, FileMode, FileAccess, FileShare)	Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním pro čtení a zápis a FileStream oprávněním ke sdílení.
FileStream(IntPtr, FileAccess, Boolean, Int32)	Zastaralé. Zastaralé. Zastaralé. Zastaralé. Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, vlastnictvím instance a FileStream `FileStream` velikostí vyrovnávací paměti.
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.
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.
FileStream(IntPtr, FileAccess, Boolean)	Zastaralé. 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.
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.
FileStream(SafeFileHandle, FileAccess, Int32, Boolean)	Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, velikostí vyrovnávací paměti a FileStream synchronním nebo asynchronním stavem.
FileStream(String, FileStreamOptions)	Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávnění ke čtení a zápisu a sdílení, velikost vyrovnávací paměti, další možnosti souborů, velikost předdefinovaného souboru a přístup k jiným datovým proudům může mít stejný soubor.
FileStream(String, FileMode)	Inicializuje novou instanci FileStream třídy se zadanou cestou a režimem vytváření.
FileStream(IntPtr, FileAccess)	Zastaralé. 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.

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.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess)

Parametry

handle: SafeFileHandle

Popisovač souboru pro soubor, který FileStream bude zapouzdřovat aktuální objekt.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje CanRead CanWrite vlastnosti a FileStream objektu.

Výjimky

ArgumentException

access není pole FileAccess .

SecurityException

Volající nemá požadované oprávnění.

IOException

Došlo k vstupně-výstupní chybě, například k chybě disku.

-nebo-

Datový proud byl zavřen.

UnauthorizedAccessException

Požadovaná operace není access povolená operačním systémem pro zadaný popisovač souboru, například když access je Write nebo ReadWrite a popisovač souboru je nastaven pro přístup jen pro čtení.

Poznámky

Při Close volání je popisovač také uzavřen a počet popisovačů souboru je snížen.

FileStream předpokládá, že má exkluzivní kontrolu nad popisovačem. Čtení, zápis nebo hledání v době, kdy FileStream je také uchováván popisovač, může způsobit poškození dat. V případě zabezpečení dat volejte Flush před použitím popisovače a vyhněte se volání jakékoli jiné metody než Close po dokončení pomocí popisovače.

Upozornění

Pokud zkompilujete sadu znaků s konkrétním kulturním nastavením a načtete stejné znaky s jiným kulturním nastavením, znaky nemusí být interpretované a mohou způsobit vyvolání výjimky.

FileShare.Read je výchozí pro tyto FileStream konstruktory bez FileShare parametru.

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

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

Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním pro přístupová práva a sdílení, velikost vyrovnávací paměti, další možnosti souborů, řízení přístupu a FileStream zabezpečení auditu.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);

new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který bude FileStream zapouzdřen aktuálním objektem.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit soubor.

rights: FileSystemRights

Bitová kombinace hodnot výčtu, která určuje přístupová práva, která se mají použít při vytváření pravidel přístupu a auditu pro soubor.

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílen procesy.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

options: FileOptions

Bitová kombinace hodnot výčtu, která určuje další možnosti souboru.

fileSecurity: FileSecurity

Objekt, který určuje řízení přístupu a audit zabezpečení souboru.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .NET Core starší než 2.1: je prázdný řetězec (""), obsahuje pouze prázdné znaky nebo obsahuje jeden path nebo více neplatných znaků.

-nebo- path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí NTFS.

NotSupportedException

path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí bez NTFS.

ArgumentOutOfRangeException

bufferSize je záporná nebo nulová.

-nebo- mode, access nebo share obsahují neplatnou hodnotu.

FileNotFoundException

Soubor se nenašel, například když je nebo a soubor mode FileMode.Truncate zadaný pomocí FileMode.Open path neexistuje. Soubor už musí existovat v těchto režimech.

IOException

Došlo k V/V chybě, například určení, kdy již existuje soubor FileMode.CreateNew path určený parametrem .

-nebo- Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenačtené jednotce.

UnauthorizedAccessException

Požadovaný operační systém nepovoluje pro zadanou hodnotu , například když je nebo a soubor nebo adresář je nastaven pro přístup access path jen pro access Write ReadWrite čtení.

-nebo- Encrypted je zadaná pro options , ale šifrování souborů se na aktuální platformě nepodporuje.

PathTooLongException

Zadaná hodnota , název souboru nebo obojí překračuje maximální délku path definovanou systémem.

PlatformNotSupportedException

Aktuální operační systém není systém Windows NT novější.

Příklady

Následující příklad zapíše data do souboru a pak je přečte pomocí FileStream objektu .

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;
using namespace System::Security::Principal;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Specify an access control list (ACL)
        FileSecurity^ fs = gcnew FileSecurity();

        fs->AddAccessRule(
            gcnew FileSystemAccessRule("MYDOMAIN\\MyAccount",
            FileSystemRights::Modify, AccessControlType::Allow));

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt",
            FileMode::Create, FileSystemRights::Modify,
            FileShare::None, 8, FileOptions::None, fs);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();

        // Open a file and read the number of bytes.

        FileStream^ fRead = 
            gcnew FileStream("test.txt", FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }

    catch (IdentityNotMappedException^)
    {
        Console::WriteLine("You need to use your own credentials " +
            " 'MYDOMAIN\\MyAccount'.");
    }

    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Specify an access control list (ACL)
                FileSecurity fs = new FileSecurity();

                fs.AddAccessRule(new FileSystemAccessRule(@"DOMAINNAME\AccountName",
                                                            FileSystemRights.ReadData,
                                                            AccessControlType.Allow));

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt", FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None, fs);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt", FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Specify an access control list (ACL)
            Dim fs As New FileSecurity()

            fs.AddAccessRule(New FileSystemAccessRule("DOMAINNAME\AccountName", FileSystemRights.ReadData, AccessControlType.Allow))

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None, fs)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Poznámky

Aplikace .NET Framework přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například \ \ .\PHYSICALDRIVE0.

Pomocí tohoto konstruktoru můžete použít přístupová práva v FileStream okamžiku vytvoření souboru. Pokud chcete získat přístup k existujícímu souboru nebo je upravit, zvažte použití metod GetAccessControl SetAccessControl a .

Parametr fileOptions slouží k poskytnutí přístupu k pokročilejším operacím, které lze využít při vytváření FileStream objektu.

Parametrem může být název souboru, včetně souboru ve sdíleném souboru path UNC (Universal Naming Convention).

Poznámka

path se nevyžaduje, aby to byl soubor uložený na disku. Může to být jakákoli část systému, která podporuje přístup prostřednictvím datových proudů. Například v závislosti na systému může tato třída přistupovat k fyzickému zařízení.

CanSeek je true pro všechny FileStream objekty, které zapouzdřují soubory. Pokud path označuje zařízení, které nepodporuje hledání, CanSeek vlastnost ve výsledném objektu je FileStream false . Další informace najdete v tématu CanSeek.

Upozornění

Při kompilaci sady znaků s konkrétním kulturním nastavením a načtení stejných znaků s jiným kulturním nastavením nemusí být znaky interpretovatelné a může dojít k vyvolání výjimky.

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Důležité

Tento konstruktor v .NET Core neexistuje. Místo toho můžete od verze .NET Core 3.1 použít následující rozšiřující metodu třídy FileSystemAclExtensions uvnitř System.Security.AccessControl sestavení: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) .

Viz také

Platí pro

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ů.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);

public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);

new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který FileStream bude zapouzdřovat aktuální objekt.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak soubor otevřít nebo vytvořit.

rights: FileSystemRights

Bitová kombinace hodnot výčtu, která určuje přístupová práva, která se mají použít při vytváření pravidel přístupu a auditu pro daný soubor.

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílet procesy.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

options: FileOptions

Bitová kombinace hodnot výčtu, která určuje další možnosti souboru.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .net Core verze starší než 2,1: path je prázdný řetězec (""), obsahuje pouze mezery nebo obsahuje jeden nebo více neplatných znaků.

-nebo- path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí NTFS.

NotSupportedException

path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí bez NTFS.

ArgumentOutOfRangeException

bufferSize je záporná nebo nulová.

-nebo- mode, access nebo share obsahují neplatnou hodnotu.

FileNotFoundException

Soubor se nenašel, například když je nebo a soubor mode FileMode.Truncate zadaný pomocí FileMode.Open path neexistuje. Soubor už musí existovat v těchto režimech.

PlatformNotSupportedException

Aktuální operační systém není systém Windows NT novější.

IOException

Došlo k V/V chybě, například určení, kdy již existuje soubor FileMode.CreateNew path určený parametrem .

-nebo- Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenačtené jednotce.

UnauthorizedAccessException

-nebo- Encrypted je zadaná pro options , ale šifrování souborů se na aktuální platformě nepodporuje.

PathTooLongException

Zadaná hodnota , název souboru nebo obojí překračuje maximální délku path definovanou systémem.

Poznámky

.NET Framework nepodporuje přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například " \ \ .\PHYSICALDRIVE0".

Tento FileStream konstruktor použijte k uplatnění přístupových práv v okamžiku vytvoření souboru. Chcete-li získat přístup k právům a jejich změnám v existujícím souboru, zvažte použití GetAccessControl SetAccessControl metod a.

fileOptionsParametr slouží k poskytnutí přístupu k pokročilejším operacím, které lze využít při vytváření FileStream objektu.

pathParametr může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

Poznámka

path nemusí se jednat o soubor uložený na disku; může to být jakákoli část systému, která podporuje přístup prostřednictvím datových proudů. Například v závislosti na systému může tato třída získat přístup k fyzickému zařízení.

CanSeek je true pro všechny FileStream objekty, které zapouzdřují soubory. Pokud path indikuje zařízení, které nepodporují vyhledávání, CanSeek vlastnost na výsledku FileStream je false . Další informace najdete v tématu CanSeek.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

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ů.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, options As FileOptions)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který FileStream bude zapouzdřovat aktuální objekt.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak soubor otevřít nebo vytvořit.

access: FileAccess

Bitová kombinace hodnot výčtu, která určuje, jakým způsobem lze k souboru přistupovat FileStream objekt. Tím se také určí hodnoty vracené CanRead vlastnostmi a CanWrite FileStream objektu. CanSeek je true path v případě, že Určuje soubor na disku.

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílet procesy.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

options: FileOptions

Bitová kombinace hodnot výčtu, která určuje další možnosti souboru.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .net Core verze starší než 2,1: path je prázdný řetězec (""), obsahuje pouze mezery nebo obsahuje jeden nebo více neplatných znaků.

-nebo- path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí NTFS.

NotSupportedException

path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí, které není systémem souborů NTFS.

ArgumentOutOfRangeException

bufferSize je záporné nebo nula.

-nebo- mode, access nebo share obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen, například když mode je FileMode.Truncate nebo FileMode.Open a soubor určený uživatelem path neexistuje. Tento soubor již musí existovat v těchto režimech.

IOException

Došlo k vstupně-výstupní chybě, jako je například určení FileMode.CreateNew , kdy soubor určený parametrem path již existuje.

-nebo- Datový proud byl zavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nemapované jednotce.

UnauthorizedAccessException

accessPožadovaná služba není povolená operačním systémem pro zadanou hodnotu path , například když access je Write nebo ReadWrite a soubor nebo adresář je nastaven pro přístup jen pro čtení.

-nebo- Encrypted je určena pro options , ale šifrování souborů není na aktuální platformě podporováno.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Příklady

Následující příklad zapisuje data do souboru a poté čte data pomocí FileStream objektu.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt", FileMode::Create,
            FileAccess::ReadWrite, FileShare::None, 8, FileOptions::None);

        // Write the number of bytes to the file.
        fWrite->WriteByte((Byte)messageByte->Length);

        // Write the bytes to the file.
        fWrite->Write(messageByte, 0, messageByte->Length);

        // Close the stream.
        fWrite->Close();


        // Open a file and read the number of bytes.

        FileStream^ fRead = gcnew FileStream("test.txt", 
            FileMode::Open);

        // The first byte is the string length.
        int length = (int)fRead->ReadByte();

        // Create a new byte array for the data.
        array<Byte>^ readBytes = gcnew array<Byte>(length);

        // Read the data from the file.
        fRead->Read(readBytes, 0, readBytes->Length);

        // Close the stream.
        fRead->Close();

        // Display the data.
        Console::WriteLine(Encoding::ASCII->GetString(readBytes));

        Console::WriteLine("Done writing and reading data.");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();

                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt", FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(messageByte.Length))

            ' Write the bytes to the file.
            fWrite.Write(messageByte, 0, messageByte.Length)

            ' Close the stream.
            fWrite.Close()


            ' Open a file and read the number of bytes.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' Read the data from the file.
            fRead.Read(readBytes, 0, readBytes.Length)

            ' Close the stream.
            fRead.Close()

            ' Display the data.
            Console.WriteLine(Encoding.ASCII.GetString(readBytes))

            Console.WriteLine("Done writing and reading data.")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Poznámky

.NET Framework nepodporuje přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například " \ \ .\PHYSICALDRIVE0".

fileOptionsParametr slouží k poskytnutí přístupu k pokročilejším operacím, které lze využít při vytváření FileStream objektu.

pathParametr může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

Poznámka

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

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

Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním ke čtení a zápisu a sdílení a FileStream velikostí vyrovnávací paměti.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který bude FileStream zapouzdřen aktuálním objektem.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit soubor.

access: FileAccess

Bitová kombinace hodnot výčtu, která určuje, jak lze k souboru přistupovat FileStream objektem . Určuje také hodnoty vrácené vlastnostmi CanRead CanWrite a FileStream objektu. CanSeek je true , pokud určuje path diskový soubor.

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílen procesy.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .NET Core starší než 2.1: je prázdný řetězec (""), obsahuje pouze prázdné znaky nebo obsahuje jeden path nebo více neplatných znaků.

-nebo- path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí NTFS.

NotSupportedException

path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí bez NTFS.

ArgumentOutOfRangeException

bufferSize je záporná nebo nulová.

-nebo- mode, access nebo share obsahují neplatnou hodnotu.

FileNotFoundException

Soubor se nenašel, například když je nebo a soubor mode FileMode.Truncate zadaný pomocí FileMode.Open path neexistuje. Soubor už musí existovat v těchto režimech.

IOException

Došlo k V/V chybě, například určení, kdy již existuje soubor FileMode.CreateNew path určený parametrem .

-nebo- Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenačtené jednotce.

UnauthorizedAccessException

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Poznámky

Aplikace .NET Framework přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například \ \ .\PHYSICALDRIVE0.

Parametrem může být název souboru, včetně souboru ve sdíleném souboru path UNC (Universal Naming Convention).

Poznámka

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)

Upozornění

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Upozornění

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Upozornění

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead

Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, vlastnictvím instance, velikostí vyrovnávací paměti a synchronním FileStream FileStream nebo asynchronním stavem.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer, isAsync As Boolean)

Parametry

handle: IntPtr
nativeint

Popisovač souboru, který bude tento FileStream objekt zapouzdřit.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje vlastnosti a CanRead CanWrite FileStream objektu.

ownsHandle: Boolean

true Pokud popisovač souboru bude vlastníkem této FileStream instance, jinak false .

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

isAsync: Boolean

true pokud byl popisovač otevřen asynchronně (to znamená v překrývajícím se režimu V/V); v opačném případě false .

Atributy: ObsoleteAttribute

Výjimky

ArgumentOutOfRangeException

access je menší nebo FileAccess.Read větší než nebo je menší než nebo rovno FileAccess.ReadWrite bufferSize 0.

ArgumentException

Popisovač je neplatný.

IOException

Došlo k V/V chybě, například chyba disku.

-nebo-

Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Požadovaný typ není operačním systémem povolený pro zadaný popisovač souboru, například když je nebo a popisovač souboru je nastavený pro přístup access access jen pro Write ReadWrite čtení.

Poznámky

Objektu FileStream je dán zadaný přístup k souboru. Vlastnictví popisovače bude uvedené tak, jak je uvedeno. Pokud je FileStream tento popisovač vlastnit, volání Close metody také zavře popisovač. Konkrétně se sníží počet popisovačů souboru. Objektu FileStream je dána zadaná velikost vyrovnávací paměti.

FileStream předpokládá, že má výhradní kontrolu nad popisovačem. Čtení, zápis nebo hledání, zatímco objekt také drží popisovač, FileStream může způsobit poškození dat. Z bezpečnostních důvodů volejte před použitím popisovače a vyhněte se volání jiných metod než po Flush Close dokončení používání popisovače. Před voláním tohoto konstruktoru můžete do popisovače také číst a FileStream zapisovat.

FileShare.Read je výchozí hodnota pro FileStream tyto konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

FileStream(String, FileMode, FileAccess, FileShare)

Inicializuje novou instanci třídy se zadanou cestou, režimem vytváření, oprávněním pro čtení a zápis a FileStream oprávněním ke sdílení.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který bude FileStream zapouzdřen aktuálním objektem.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit soubor.

access: FileAccess

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílen procesy.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .NET Core starší než 2.1: je prázdný řetězec (""), obsahuje pouze prázdné znaky nebo obsahuje jeden path nebo více neplatných znaků.

-nebo- path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí NTFS.

NotSupportedException

path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí bez NTFS.

FileNotFoundException

Soubor se nenašel, například když je nebo a soubor mode FileMode.Truncate zadaný pomocí FileMode.Open path neexistuje. Soubor už musí existovat v těchto režimech.

IOException

Došlo k V/V chybě, například určení, kdy již existuje soubor FileMode.CreateNew path určený parametrem .

-nebo- Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenačtené jednotce.

UnauthorizedAccessException

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

Příklady

Tento příklad kódu je součástí většího příkladu pro Lock metodu .

FileStream^ fileStream = gcnew FileStream( "Test#@@#.dat",FileMode::OpenOrCreate,FileAccess::ReadWrite,FileShare::ReadWrite );

using(FileStream fileStream = new FileStream(
    "Test#@@#.dat", FileMode.OpenOrCreate,
    FileAccess.ReadWrite, FileShare.ReadWrite))

Dim aFileStream As New FileStream( _
    "Test#@@#.dat", FileMode.OpenOrCreate, _
    FileAccess.ReadWrite, FileShare.ReadWrite)

Poznámky

Aplikace .NET Framework přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například \ \ .\PHYSICALDRIVE0.

Parametrem může být název souboru, včetně souboru ve sdíleném souboru path UNC (Universal Naming Convention).

Konstruktoru je uděleno oprávnění ke čtení a zápisu k souboru a je otevřen sdílením oprávnění ke čtení (to znamená, že požadavky na otevření souboru pro zápis tímto nebo jiným procesem selžou, dokud se objekt nezavře, ale pokusy o čtení budou FileStream úspěšné). Velikost vyrovnávací paměti je nastavená na výchozí velikost 4 096 bajtů (4 kB).

Poznámka

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

FileStream(IntPtr, FileAccess, Boolean, Int32)

Upozornění

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Upozornění

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Upozornění

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead

Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, vlastnictvím instance a FileStream FileStream velikostí vyrovnávací paměti.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer)

Parametry

handle: IntPtr
nativeint

Popisovač souboru, který bude tento FileStream objekt zapouzdřit.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje vlastnosti a CanRead CanWrite FileStream objektu.

ownsHandle: Boolean

true Pokud popisovač souboru bude vlastníkem této FileStream instance, jinak false .

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

Atributy: ObsoleteAttribute

Výjimky

ArgumentOutOfRangeException

bufferSize je záporná.

IOException

Došlo k V/V chybě, například chyba disku.

-nebo-

Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Poznámky

FileShare.Read je výchozí hodnota pro FileStream tyto konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

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.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, bool useAsync);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, bool useAsync);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * bool -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, useAsync As Boolean)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který bude FileStream zapouzdřen aktuálním objektem.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak otevřít nebo vytvořit soubor.

access: FileAccess

share: FileShare

Bitová kombinace hodnot výčtu, která určuje, jak bude soubor sdílen procesy.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

useAsync: Boolean

Určuje, jestli se mají použít asynchronní vstupně-výstupní operace, nebo synchronní vstupně-výstupní operace. Mějte však na vědomí, že základní operační systém nemusí podporovat asynchronní vstupně-výstupní operace, takže při zadávání může být popisovač otevřen synchronně v závislosti true na platformě. Při asynchronním otevření mají metody a lepší výkon při velkých čteních nebo zápisech, ale pro menší čtení nebo zápisy můžou být BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) mnohem pomalejší. Pokud je aplikace navržena tak, aby využila výhod asynchronního I/O, nastavte useAsync parametr na true . Použití asynchronního vstupu/výstupu dokáže správně zrychlit aplikace, a to jako násobek 10, ale její použití bez nutnosti přenavrhování aplikace pro asynchronní vstupně-výstupní operace může snížit výkon, a to až jako faktor 10.

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .net Core verze starší než 2,1: path je prázdný řetězec (""), obsahuje pouze mezery nebo obsahuje jeden nebo více neplatných znaků.

-nebo- path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí NTFS.

NotSupportedException

path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí, které není systémem souborů NTFS.

ArgumentOutOfRangeException

bufferSize je záporné nebo nula.

-nebo- mode, access nebo share obsahuje neplatnou hodnotu.

FileNotFoundException

Soubor nebyl nalezen, například když mode je FileMode.Truncate nebo FileMode.Open a soubor určený uživatelem path neexistuje. Tento soubor již musí existovat v těchto režimech.

IOException

Došlo k vstupně-výstupní chybě, jako je například určení FileMode.CreateNew , kdy soubor určený parametrem path již existuje.

-nebo- Datový proud byl zavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nemapované jednotce.

UnauthorizedAccessException

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Příklady

Následující příklad kódu ukazuje, jak asynchronně zapsat data do souboru a ověřit, zda byla data správně zapsána. Vytvoří se State objekt, který předáte informace z hlavního vlákna do EndReadCallback metody a EndWriteCallback .

using namespace System;
using namespace System::IO;
using namespace System::Threading;

// Maintain state information to be passed to 
// EndWriteCallback and EndReadCallback.
ref class State
{
private:

   // fStream is used to read and write to the file.
   FileStream^ fStream;

   // writeArray stores data that is written to the file.
   array<Byte>^writeArray;

   // readArray stores data that is read from the file.
   array<Byte>^readArray;

   // manualEvent signals the main thread 
   // when verification is complete.
   ManualResetEvent^ manualEvent;

public:
   State( FileStream^ fStream, array<Byte>^writeArray, ManualResetEvent^ manualEvent )
   {
      this->fStream = fStream;
      this->writeArray = writeArray;
      this->manualEvent = manualEvent;
      readArray = gcnew array<Byte>(writeArray->Length);
   }


   property FileStream^ FStream 
   {
      FileStream^ get()
      {
         return fStream;
      }

   }

   property array<Byte>^ WriteArray 
   {
      array<Byte>^ get()
      {
         return writeArray;
      }

   }

   property array<Byte>^ ReadArray 
   {
      array<Byte>^ get()
      {
         return readArray;
      }

   }

   property ManualResetEvent^ ManualEvent 
   {
      ManualResetEvent^ get()
      {
         return manualEvent;
      }

   }

};

ref class FStream
{
private:

   // When BeginRead is finished reading data from the file, the 
   // EndReadCallback method is called to end the asynchronous 
   // read operation and then verify the data.
   static void EndReadCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      int readCount = tempState->FStream->EndRead( asyncResult );
      int i = 0;
      while ( i < readCount )
      {
         if ( tempState->ReadArray[ i ] != tempState->WriteArray[ i++ ] )
         {
            Console::WriteLine( "Error writing data." );
            tempState->FStream->Close();
            return;
         }
      }

      Console::WriteLine( "The data was written to {0} "
      "and verified.", tempState->FStream->Name );
      tempState->FStream->Close();
      
      // Signal the main thread that the verification is finished.
      tempState->ManualEvent->Set();
   }


public:

   // When BeginWrite is finished writing data to the file, the
   // EndWriteCallback method is called to end the asynchronous 
   // write operation and then read back and verify the data.
   static void EndWriteCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      FileStream^ fStream = tempState->FStream;
      fStream->EndWrite( asyncResult );
      
      // Asynchronously read back the written data.
      fStream->Position = 0;
      asyncResult = fStream->BeginRead( tempState->ReadArray, 0, tempState->ReadArray->Length, gcnew AsyncCallback( &FStream::EndReadCallback ), tempState );
      
      // Concurrently do other work, such as 
      // logging the write operation.
   }

};


int main()
{
   
   // Create a synchronization object that gets 
   // signaled when verification is complete.
   ManualResetEvent^ manualEvent = gcnew ManualResetEvent( false );
   
   // Create the data to write to the file.
   array<Byte>^writeArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( writeArray );
   FileStream^ fStream = gcnew FileStream(  "Test#@@#.dat",FileMode::Create,FileAccess::ReadWrite,FileShare::None,4096,true );
   
   // Check that the FileStream was opened asynchronously.
   Console::WriteLine( "fStream was {0}opened asynchronously.", fStream->IsAsync ? (String^)"" : "not " );
   
   // Asynchronously write to the file.
   IAsyncResult^ asyncResult = fStream->BeginWrite( writeArray, 0, writeArray->Length, gcnew AsyncCallback( &FStream::EndWriteCallback ), gcnew State( fStream,writeArray,manualEvent ) );
   
   // Concurrently do other work and then wait 
   // for the data to be written and verified.
   manualEvent->WaitOne( 5000, false );
}

using System;
using System.IO;
using System.Threading;

class FStream
{
    static void Main()
    {
        // Create a synchronization object that gets
        // signaled when verification is complete.
        ManualResetEvent manualEvent = new ManualResetEvent(false);

        // Create random data to write to the file.
        byte[] writeArray = new byte[100000];
        new Random().NextBytes(writeArray);

        FileStream fStream =
            new FileStream("Test#@@#.dat", FileMode.Create,
            FileAccess.ReadWrite, FileShare.None, 4096, true);

        // Check that the FileStream was opened asynchronously.
        Console.WriteLine("fStream was {0}opened asynchronously.",
            fStream.IsAsync ? "" : "not ");

        // Asynchronously write to the file.
        IAsyncResult asyncResult = fStream.BeginWrite(
            writeArray, 0, writeArray.Length,
            new AsyncCallback(EndWriteCallback),
            new State(fStream, writeArray, manualEvent));

        // Concurrently do other work and then wait
        // for the data to be written and verified.
        manualEvent.WaitOne(5000, false);
    }

    // When BeginWrite is finished writing data to the file, the
    // EndWriteCallback method is called to end the asynchronous
    // write operation and then read back and verify the data.
    static void EndWriteCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        FileStream fStream = tempState.FStream;
        fStream.EndWrite(asyncResult);

        // Asynchronously read back the written data.
        fStream.Position = 0;
        asyncResult = fStream.BeginRead(
            tempState.ReadArray, 0 , tempState.ReadArray.Length,
            new AsyncCallback(EndReadCallback), tempState);

        // Concurrently do other work, such as
        // logging the write operation.
    }

    // When BeginRead is finished reading data from the file, the
    // EndReadCallback method is called to end the asynchronous
    // read operation and then verify the data.
    static void EndReadCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        int readCount = tempState.FStream.EndRead(asyncResult);

        int i = 0;
        while(i < readCount)
        {
            if(tempState.ReadArray[i] != tempState.WriteArray[i++])
            {
                Console.WriteLine("Error writing data.");
                tempState.FStream.Close();
                return;
            }
        }
        Console.WriteLine("The data was written to {0} and verified.",
            tempState.FStream.Name);
        tempState.FStream.Close();

        // Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set();
    }

    // Maintain state information to be passed to
    // EndWriteCallback and EndReadCallback.
    class State
    {
        // fStream is used to read and write to the file.
        FileStream fStream;

        // writeArray stores data that is written to the file.
        byte[] writeArray;

        // readArray stores data that is read from the file.
        byte[] readArray;

        // manualEvent signals the main thread
        // when verification is complete.
        ManualResetEvent manualEvent;

        public State(FileStream fStream, byte[] writeArray,
            ManualResetEvent manualEvent)
        {
            this.fStream   = fStream;
            this.writeArray = writeArray;
            this.manualEvent = manualEvent;
            readArray = new byte[writeArray.Length];
        }

        public FileStream FStream
        { get{ return fStream; } }

        public byte[] WriteArray
        { get{ return writeArray; } }

        public byte[] ReadArray
        { get{ return readArray; } }

        public ManualResetEvent ManualEvent
        { get{ return manualEvent; } }
    }
}

Imports System.IO
Imports System.Threading

Class FStream

    Shared Sub Main()

        ' Create a synchronization object that gets 
        ' signaled when verification is complete.
        Dim manualEvent As New ManualResetEvent(False)

        ' Create random data to write to the file.
        Dim writeArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(writeArray)

        Dim fStream As New FileStream("Test#@@#.dat", _
            FileMode.Create, FileAccess.ReadWrite, _
            FileShare.None, 4096, True)

        ' Check that the FileStream was opened asynchronously.
        If fStream.IsAsync = True
            Console.WriteLine("fStream was opened asynchronously.")
        Else
            Console.WriteLine("fStream was not opened asynchronously.")
        End If

        ' Asynchronously write to the file.
        Dim asyncResult As IAsyncResult = fStream.BeginWrite( _
            writeArray, 0, writeArray.Length, _
            AddressOf EndWriteCallback , _
            New State(fStream, writeArray, manualEvent))

        ' Concurrently do other work and then wait
        ' for the data to be written and verified.
        manualEvent.WaitOne(5000, False)
    End Sub

    ' When BeginWrite is finished writing data to the file, the
    ' EndWriteCallback method is called to end the asynchronous 
    ' write operation and then read back and verify the data.
    Private Shared Sub EndWriteCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim fStream As FileStream = tempState.FStream
        fStream.EndWrite(asyncResult)

        ' Asynchronously read back the written data.
        fStream.Position = 0
        asyncResult = fStream.BeginRead( _ 
            tempState.ReadArray, 0 , tempState.ReadArray.Length, _
            AddressOf EndReadCallback, tempState)

        ' Concurrently do other work, such as 
        ' logging the write operation.
    End Sub

    ' When BeginRead is finished reading data from the file, the 
    ' EndReadCallback method is called to end the asynchronous 
    ' read operation and then verify the data.
   Private Shared Sub EndReadCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim readCount As Integer = _
            tempState.FStream.EndRead(asyncResult)

        Dim i As Integer = 0
        While(i < readCount)
            If(tempState.ReadArray(i) <> tempState.WriteArray(i))
                Console.WriteLine("Error writing data.")
                tempState.FStream.Close()
                Return
            End If
            i += 1
        End While

        Console.WriteLine("The data was written to {0} and " & _
            "verified.", tempState.FStream.Name)
        tempState.FStream.Close()

        ' Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set()
    End Sub

    ' Maintain state information to be passed to 
    ' EndWriteCallback and EndReadCallback.
    Private Class State

        ' fStreamValue is used to read and write to the file.
        Dim fStreamValue As FileStream

        ' writeArrayValue stores data that is written to the file.
        Dim writeArrayValue As Byte()

        ' readArrayValue stores data that is read from the file.
        Dim readArrayValue As Byte()

        ' manualEvent signals the main thread 
        ' when verification is complete.
        Dim manualEventValue As ManualResetEvent 

        Sub New(aStream As FileStream, anArray As Byte(), _
            manualEvent As ManualResetEvent)

            fStreamValue     = aStream
            writeArrayValue  = anArray
            manualEventValue = manualEvent
            readArrayValue   = New Byte(anArray.Length - 1){}
        End Sub    

            Public ReadOnly Property FStream() As FileStream
                Get
                    Return fStreamValue
                End Get
            End Property

            Public ReadOnly Property WriteArray() As Byte()
                Get
                    Return writeArrayValue
                End Get
            End Property

            Public ReadOnly Property ReadArray() As Byte()
                Get
                    Return readArrayValue
                End Get
            End Property

            Public ReadOnly Property ManualEvent() As ManualResetEvent
                Get
                    Return manualEventValue
                End Get
            End Property
    End Class 
   
End Class

Poznámky

.NET Framework nepodporuje přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například " \ \ .\PHYSICALDRIVE0".

pathParametr může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

Poznámka

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

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.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);

public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access);

new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode, access As FileAccess)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který FileStream bude zapouzdřovat aktuální objekt.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak soubor otevřít nebo vytvořit.

access: FileAccess

Výjimky

ArgumentNullException

path je null.

ArgumentException

.NET Framework a .NET Core starší než 2.1: je prázdný řetězec (""), obsahuje pouze prázdné znaky nebo obsahuje jeden path nebo více neplatných znaků.

-nebo- path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí NTFS.

NotSupportedException

path odkazuje na zařízení, které není v souboru, například "con:", "com1:", "lpt1:" atd. v prostředí bez NTFS.

FileNotFoundException

Soubor se nenašel, například když je nebo a soubor mode FileMode.Truncate zadaný pomocí FileMode.Open path neexistuje. Soubor už musí existovat v těchto režimech.

IOException

Došlo k V/V chybě, například určení, kdy již existuje soubor FileMode.CreateNew path určený parametrem .

-nebo- Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nenačtené jednotce.

UnauthorizedAccessException

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

Poznámky

.NET Framework nepodporuje přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například " \ \ .\PHYSICALDRIVE0".

Parametrem může být název souboru, včetně souboru ve sdíleném souboru path UNC (Universal Naming Convention).

Poznámka

FileShare.Read je výchozí hodnota pro FileStream tyto konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

FileStream(IntPtr, FileAccess, Boolean)

Upozornění

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Upozornění

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.

Upozornění

Use FileStream(SafeFileHandle handle, FileAccess access) instead

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.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) and optionally make a new SafeFileHandle with ownsHandle=false if needed instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean)

Parametry

handle: IntPtr
nativeint

Popisovač souboru pro soubor, který FileStream bude zapouzdřovat aktuální objekt.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje CanRead CanWrite vlastnosti a FileStream objektu.

ownsHandle: Boolean

true , pokud bude obslužná rutina souboru vlastníkem této FileStream instance. v opačném případě false .

Atributy: ObsoleteAttribute

Výjimky

ArgumentException

access není pole FileAccess .

SecurityException

Volající nemá požadované oprávnění.

IOException

Došlo k vstupně-výstupní chybě, například k chybě disku.

-nebo-

Datový proud byl zavřen.

UnauthorizedAccessException

Poznámky

FileStreamObjektu je udělen zadaný přístup k souboru. Vlastnictví popisovače bude stanoveno. Pokud tento proces vlastní popisovač, volání Close metody také uzavře popisovač a počet popisovačů souboru bude snížen. FileStreamObjektu je přidělena výchozí velikost vyrovnávací paměti 4096 bajtů.

FileStream předpokládá, že má exkluzivní kontrolu nad popisovačem. Čtení, zápis nebo hledání v době, kdy FileStream je také uchováván popisovač, může způsobit poškození dat. V případě zabezpečení dat volejte Flush před použitím popisovače a vyhněte se volání jiných metod než Close po provedení použití popisovače.

FileShare.Read je výchozí pro tyto FileStream konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

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.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer)

Parametry

handle: SafeFileHandle

Popisovač souboru pro soubor, který FileStream bude zapouzdřovat aktuální objekt.

access: FileAccess

FileAccessKonstanta, která nastavuje CanRead CanWrite vlastnosti a FileStream objektu.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

Výjimky

ArgumentException

handleParametr je neplatným popisovačem.

-nebo- handleParametr je synchronní popisovač a byl použit asynchronně.

ArgumentOutOfRangeException

bufferSizeParametr je záporný.

IOException

Došlo k vstupně-výstupní chybě, například k chybě disku.

-nebo-

Datový proud byl zavřen.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Poznámky

FileShare.Read je výchozí pro tyto FileStream konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Inicializuje novou instanci třídy pro zadaný popisovač souboru se zadaným oprávněním ke čtení a zápisu, velikostí vyrovnávací paměti a FileStream synchronním nebo asynchronním stavem.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize, bool isAsync);

public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize, bool isAsync);

new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int * bool -> System.IO.FileStream

Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer, isAsync As Boolean)

Parametry

handle: SafeFileHandle

Popisovač souboru, který bude tento FileStream objekt zapouzdřit.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje vlastnosti a CanRead CanWrite FileStream objektu.

bufferSize: Int32

Kladná Int32 hodnota větší než 0 označující velikost vyrovnávací paměti. Výchozí velikost vyrovnávací paměti je 4096.

isAsync: Boolean

true pokud byl popisovač otevřen asynchronně (to znamená v překrývajícím se režimu V/V); v opačném případě false .

Výjimky

ArgumentException

Parametr handle je neplatný popisovač.

-nebo- Parametr handle je synchronní popisovač a byl použit asynchronně.

ArgumentOutOfRangeException

Parametr bufferSize je záporný.

IOException

Došlo k V/V chybě, například chyba disku.

-nebo-

Datový proud byl uzavřen.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Poznámky

Parametr nastavíte isAsync na , aby se popisovač souboru otevřel true asynchronně. Pokud je parametr , stream využívá překrývající se true V/V k asynchronnímu provádění operací se soubory. Parametr však nemusí být k true volání metody , nebo ReadAsync WriteAsync CopyToAsync . Pokud je parametr a voláte asynchronní operace čtení a zápisu, vlákno uživatelského rozhraní stále není blokované, ale skutečná vstupně-výstupní operace se isAsync false provádí synchronně.

FileShare.Read je výchozí hodnota pro FileStream tyto konstruktory bez FileShare parametru.

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné V/V úlohy.

Viz také

Platí pro

FileStream(String, FileStreamOptions)

Inicializuje novou instanci FileStream třídy se zadanou cestou, režimem vytváření, oprávnění ke čtení a zápisu a sdílení, velikost vyrovnávací paměti, další možnosti souborů, velikost předdefinovaného souboru a přístup k jiným datovým proudům může mít stejný soubor.

public:
 FileStream(System::String ^ path, System::IO::FileStreamOptions ^ options);

public FileStream (string path, System.IO.FileStreamOptions options);

new System.IO.FileStream : string * System.IO.FileStreamOptions -> System.IO.FileStream

Public Sub New (path As String, options As FileStreamOptions)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který FileStream bude zapouzdřovat aktuální instance.

options: FileStreamOptions

Objekt, který popisuje volitelné FileStream parametry, které mají být použity.

Výjimky

ArgumentNullException

path nebo options je null .

ArgumentException

path je prázdný řetězec, obsahuje pouze mezery nebo obsahuje jeden nebo více neplatných znaků.

-nebo-

path odkazuje na nesouborové zařízení, například con:, COM1:nebo LPT1:, v prostředí NTFS.

NotSupportedException

path odkazuje na nesouborové zařízení, například con:, COM1:, LPT1:, atd. v prostředí, které není NTFS.

FileNotFoundException

Soubor nebyl nalezen, například když Mode je FileMode.Truncate nebo FileMode.Open a soubor určený uživatelem path neexistuje. Tento soubor již musí existovat v těchto režimech.

IOException

Došlo k vstupně-výstupní chybě, jako je například určení FileMode.CreateNew , kdy soubor určený parametrem path již existuje.

-nebo-

Datový proud byl zavřen.

-nebo-

Disk byl plný (Pokud PreallocationSize byl k dispozici a odkazoval path na běžný soubor).

-nebo-

Soubor byl příliš velký (Pokud PreallocationSize byl k dispozici a odkazoval path na běžný soubor).

SecurityException

Volající nemá požadované oprávnění.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nemapované jednotce.

UnauthorizedAccessException

AccessPožadovaná služba není povolená operačním systémem pro zadanou hodnotu path , například když Access je Write nebo ReadWrite a soubor nebo adresář je nastaven pro přístup jen pro čtení.

-nebo-

Encrypted je určena pro Options , ale šifrování souborů není na aktuální platformě podporováno.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Poznámky

Zadáním hodnoty pro PreallocationSize získáte nápovědu týkající se velikosti předalokace, ale ne silné záruku. Úplné podrobnosti o využití najdete v dokumentaci k PreallocationSize .

Platí pro

FileStream(String, FileMode)

Inicializuje novou instanci FileStream třídy se zadanou cestou a režimem vytváření.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode);

public FileStream (string path, System.IO.FileMode mode);

new System.IO.FileStream : string * System.IO.FileMode -> System.IO.FileStream

Public Sub New (path As String, mode As FileMode)

Parametry

path: String

Relativní nebo absolutní cesta k souboru, který FileStream bude zapouzdřovat aktuální objekt.

mode: FileMode

Jedna z hodnot výčtu, která určuje, jak soubor otevřít nebo vytvořit.

Výjimky

ArgumentException

.NET Framework a .net Core verze starší než 2,1: path je prázdný řetězec (""), obsahuje pouze mezery nebo obsahuje jeden nebo více neplatných znaků.

-nebo- path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí NTFS.

NotSupportedException

path odkazuje na nesouborové zařízení, jako je "con:", "COM1:", "LPT1:", atd. v prostředí, které není systémem souborů NTFS.

ArgumentNullException

path je null.

SecurityException

Volající nemá požadované oprávnění.

FileNotFoundException

Soubor nebyl nalezen, například když mode je FileMode.Truncate nebo FileMode.Open a soubor určený uživatelem path neexistuje. Tento soubor již musí existovat v těchto režimech.

UnauthorizedAccessException

path Určuje soubor, který je jen pro čtení.

IOException

Došlo k vstupně-výstupní chybě, jako je například určení FileMode.CreateNew , kdy soubor určený parametrem path již existuje.

-nebo- Datový proud byl zavřen.

DirectoryNotFoundException

Zadaná cesta je neplatná, například na nemapované jednotce.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

ArgumentOutOfRangeException

mode obsahuje neplatnou hodnotu.

Příklady

Následující příklad kódu ukazuje, jak zapsat data do souboru, bajt po bajtu a poté ověřit, zda byla data správně zapsána.

using namespace System;
using namespace System::IO;
int main()
{
   String^ fileName =  "Test@##@.dat";
   
   // Create random data to write to the file.
   array<Byte>^dataArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( dataArray );
   FileStream^ fileStream = gcnew FileStream( fileName,FileMode::Create );
   try
   {
      
      // Write the data to the file, byte by byte.
      for ( int i = 0; i < dataArray->Length; i++ )
      {
         fileStream->WriteByte( dataArray[ i ] );

      }
      
      // Set the stream position to the beginning of the file.
      fileStream->Seek( 0, SeekOrigin::Begin );
      
      // Read and verify the data.
      for ( int i = 0; i < fileStream->Length; i++ )
      {
         if ( dataArray[ i ] != fileStream->ReadByte() )
         {
            Console::WriteLine( "Error writing data." );
            return  -1;
         }

      }
      Console::WriteLine( "The data was written to {0} "
      "and verified.", fileStream->Name );
   }
   finally
   {
      fileStream->Close();
   }

}

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}

Imports System.IO
Imports System.Text

Class FStream

    Shared Sub Main()

        Const fileName As String = "Test#@@#.dat"

        ' Create random data to write to the file.
        Dim dataArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(dataArray)

        Dim fileStream As FileStream = _
            new FileStream(fileName, FileMode.Create)
        Try

            ' Write the data to the file, byte by byte.
            For i As Integer = 0 To dataArray.Length - 1
                fileStream.WriteByte(dataArray(i))
            Next i

            ' Set the stream position to the beginning of the stream.
            fileStream.Seek(0, SeekOrigin.Begin)

            ' Read and verify the data.
            For i As Integer = 0 To _
                CType(fileStream.Length, Integer) - 1

                If dataArray(i) <> fileStream.ReadByte() Then
                    Console.WriteLine("Error writing data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written to {0} " & _
                "and verified.", fileStream.Name)
        Finally
            fileStream.Close()
        End Try
    
    End Sub
End Class

Poznámky

.NET Framework nepodporuje přímý přístup k fyzickým diskům prostřednictvím cest, které jsou názvy zařízení, například " \ \ .\PHYSICALDRIVE0".

pathParametr může být název souboru, včetně souboru ve sdílené složce UNC (Universal Naming Convention).

Konstruktoru je udělen přístup pro čtení a zápis k souboru a je otevřen sdílení přístupu pro čtení (to znamená, že žádosti o otevření souboru pro zápis tímto nebo jiným procesem selžou, dokud nebude FileStream objekt zavřen, ale pokusy o čtení budou úspěšné).

Tento konstruktor nelze použít k otevření souborů jen pro čtení; místo toho je nutné použít konstruktor, který přijímá FileAccess parametr s hodnotou nastavenou na FileAccess.Read .

Velikost vyrovnávací paměti je nastavená na výchozí velikost 4096 bajtů (4 KB).

Poznámka

FileShare.Read je výchozí pro tyto FileStream konstruktory bez FileShare parametru.

Pro konstruktory bez FileAccess parametru, pokud je mode parametr nastaven na hodnotu Append , Write je výchozím přístupem. V opačném případě je přístup nastaven na ReadWrite .

Upozornění

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro

FileStream(IntPtr, FileAccess)

Upozornění

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. https://go.microsoft.com/fwlink/?linkid=14202

Upozornění

This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.

Upozornění

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. http://go.microsoft.com/fwlink/?linkid=14202

Upozornění

Use FileStream(SafeFileHandle handle, FileAccess access) instead

Inicializuje novou instanci FileStream třídy pro zadaný popisovač souboru se zadaným oprávněním pro čtení a zápis.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access);

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated. Use FileStream(SafeFileHandle handle, FileAccess access) instead.")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream

Public Sub New (handle As IntPtr, access As FileAccess)

Parametry

handle: IntPtr
nativeint

Popisovač souboru pro soubor, který FileStream bude zapouzdřovat aktuální objekt.

access: FileAccess

Bitová kombinace hodnot výčtu, která nastavuje CanRead CanWrite vlastnosti a FileStream objektu.

Atributy: ObsoleteAttribute

Výjimky

ArgumentException

access není pole FileAccess .

SecurityException

Volající nemá požadované oprávnění.

IOException

Došlo k vstupně-výstupní chybě, například k chybě disku.

-nebo-

Datový proud byl zavřen.

UnauthorizedAccessException

Poznámky

Při Close volání je popisovač také uzavřen a počet popisovačů souboru je snížen.

Upozornění

FileShare.Read je výchozí pro tyto FileStream konstruktory bez FileShare parametru.

Seznam běžných operací se soubory a adresáři najdete v tématu běžné vstupně-výstupní úlohy.

Viz také

Platí pro