FileMode Výčet

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.IO.FileSystem.Primitives.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
FileMode.cs
Zdroj:
FileMode.cs
Zdroj:
LowLevelMonitor.Unix.cs

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

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
Dědičnost
Object
ValueType
Enum
FileMode
Atributy
SerializableAttribute ComVisibleAttribute

Pole

Name Hodnota Description
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.
Create 2

Určuje, že operační systém by měl vytvořit nový soubor. Pokud soubor již existuje, přepíše se. To vyžaduje Write oprávnění. FileMode.Create je ekvivalentní požadavku, aby v případě, že soubor neexistuje, použijte CreateNew; jinak použijte Truncate. Pokud soubor již existuje, ale je skrytým souborem UnauthorizedAccessException , vyvolá se výjimka.
Open 3

Určuje, že operační systém by měl otevřít existující soubor. Možnost otevření souboru 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 se měl vytvořit nový soubor. Pokud je soubor otevřen s oprávněním FileAccess.Read, Read je vyžadováno oprávnění. Pokud je FileAccess.Writepřístup k souborům, Write vyžaduje se oprávnění. Pokud je soubor otevřen pomocí FileAccess.ReadWrite, jsou vyžadována obě Read i Write oprávnění.
Truncate 5

Určuje, že operační systém by měl otevřít existující soubor. Když je soubor otevřen, měl by být zkrácen tak, aby jeho velikost byla nula bajtů. To vyžaduje Write oprávnění. Pokusí se číst ze souboru otevřeného s FileMode.Truncate příčinou ArgumentException výjimky.
Append 6

Otevře soubor, pokud existuje a hledá 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 vyhledání pozice před koncem souboru vyvolá IOException výjimku a všechny pokusy o čtení se nezdaří a vyvolá NotSupportedException výjimku.

Příklady

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

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 řídit, jak je soubor otevřen.

FileMode Parametry určují, zda je soubor přepsán, vytvořen, otevřen nebo jeho kombinací. Slouží Open k otevření existujícího souboru. Chcete-li připojit k souboru, použijte Append. Pokud chcete soubor zkrátit nebo vytvořit soubor, pokud neexistuje, použijte Create.

Platí pro

Viz také