FileMode Výčet

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Určuje, jak má operační systém otevřít soubor.

public enum class FileMode

public enum FileMode

type FileMode = 

Public Enum FileMode

Dědičnost

Object

ValueType

Enum

FileMode

Pole

Append	6	Otevře soubor, pokud existuje, a hledá až na konec souboru, nebo vytvoří nový soubor. To vyžaduje Append oprávnění. FileMode.Append lze použít pouze ve spojení s FileAccess.Write. Pokus o umístění před koncem souboru vyvolá IOException výjimku a jakýkoli pokus o čtení selže a vyvolá NotSupportedException výjimku.
Create	2	Určuje, že operační systém by měl vytvořit nový soubor. Pokud už soubor existuje, přepíše se. To vyžaduje Write oprávnění. FileMode.Create je ekvivalentní požadavku, že pokud soubor neexistuje, použijte CreateNew. V opačném případě použijte Truncate. Pokud soubor již existuje, ale jedná se o skrytý soubor, UnauthorizedAccessException vyvolá se výjimka.
CreateNew	1	Určuje, že operační systém by měl vytvořit nový soubor. To vyžaduje Write oprávnění. Pokud soubor již existuje, IOException vyvolá se výjimka.
Open	3	Určuje, že operační systém má otevřít existující soubor. Možnost otevřít soubor závisí na hodnotě určené výčtem FileAccess . Pokud FileNotFoundException soubor neexistuje, vyvolá se výjimka.
OpenOrCreate	4	Určuje, že operační systém by měl otevřít soubor, pokud existuje; jinak by měl být vytvořen nový soubor. Pokud je soubor otevřen pomocí FileAccess.Readpříkazu , Read je vyžadováno oprávnění. Pokud je FileAccess.Writepřístup k souboru , Write je potřeba oprávnění. Pokud je soubor otevřen pomocí FileAccess.ReadWritepříkazu , jsou vyžadována oprávnění i ReadWrite oprávnění.
Truncate	5	Určuje, že operační systém má otevřít existující soubor. Při otevření souboru by měl být zkrácen tak, aby jeho velikost byla nula bajtů. To vyžaduje Write oprávnění. Pokusy o čtení ze souboru otevřeného s FileMode.Truncate způsobí ArgumentException výjimku.

Příklady

Následující FileStream konstruktor otevře existující soubor (FileMode.Open).

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Poznámky

Příklad vytvoření souboru a zápisu textu do souboru najdete v tématu Postupy: Zápis textu do souboru. Příklad čtení textu ze souboru najdete v tématu Postupy: Čtení textu ze souboru. Příklad čtení z binárního souboru a zápisu do binárního souboru najdete v tématu Postupy: Čtení a zápis do nově vytvořeného datového souboru.

Parametr FileMode je zadán v mnoha konstruktorech pro FileStream, IsolatedStorageFileStreama v Open metodách File a FileInfo k řízení způsobu otevření souboru.

FileMode parametry určují, jestli se soubor přepíše, vytvoří, otevře nebo zkombinuje. Slouží Open k otevření existujícího souboru. K připojení k souboru použijte Append. Pokud chcete soubor zkrátit nebo vytvořit soubor, pokud neexistuje, použijte Create.

Viz také

• Open(String, FileMode)
• Open(FileMode)
• FileStream
• IsolatedStorageFileStream
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru