Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

FileMode Wyliczenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestawy:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.IO.FileSystem.Primitives.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Określa sposób otwierania pliku przez system operacyjny.

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
Dziedziczenie
Object
ValueType
Enum
FileMode
Atrybuty
SerializableAttribute ComVisibleAttribute

Pola

Nazwa Wartość Opis
Append 6

Otwiera plik, jeśli istnieje i szuka końca pliku, lub tworzy nowy plik. Append Wymaga to uprawnień. FileMode.Append można używać tylko w połączeniu z FileAccess.Write. Próba wyszukiwania pozycji przed końcem pliku zgłasza IOException wyjątek, a próba odczytu kończy się niepowodzeniem i zgłasza NotSupportedException wyjątek.
Create 2

Określa, że system operacyjny powinien utworzyć nowy plik. Jeśli plik już istnieje, zostanie zastąpiony. Write Wymaga to uprawnień. FileMode.Createjest odpowiednikiem żądania, że jeśli plik nie istnieje, użyj ; CreateNeww przeciwnym razie użyj .Truncate Jeśli plik już istnieje, ale jest ukrytym plikiem UnauthorizedAccessException , zgłaszany jest wyjątek.
CreateNew 1

Określa, że system operacyjny powinien utworzyć nowy plik. Write Wymaga to uprawnień. Jeśli plik już istnieje, IOException zgłaszany jest wyjątek.
Open 3

Określa, że system operacyjny powinien otworzyć istniejący plik. Możliwość otwierania pliku zależy od wartości określonej przez FileAccess wyliczenie. Jeśli FileNotFoundException plik nie istnieje, zgłaszany jest wyjątek.
OpenOrCreate 4

Określa, że system operacyjny powinien otworzyć plik, jeśli istnieje; w przeciwnym razie należy utworzyć nowy plik. Jeśli plik jest otwarty za pomocą FileAccess.Readpolecenia , Read wymagane jest uprawnienie. Jeśli dostęp do pliku to FileAccess.Write, Write wymagane jest uprawnienie. Jeśli plik jest otwarty za pomocą FileAccess.ReadWritepolecenia , wymagane są zarówno uprawnienia, jak Read i Write .
Truncate 5

Określa, że system operacyjny powinien otworzyć istniejący plik. Po otwarciu pliku powinien zostać obcięty tak, aby jego rozmiar był zerowy. Write Wymaga to uprawnień. Próby odczytu z pliku otwartego z FileMode.Truncate powodu wyjątku ArgumentException .

Przykłady

Poniższy FileStream konstruktor otwiera istniejący plik (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)

Uwagi

Przykład tworzenia pliku i zapisywania tekstu w pliku można znaleźć w temacie How to: Write Text to a File (Instrukcje: zapisywanie tekstu w pliku). Przykład odczytywania tekstu z pliku można znaleźć w temacie How to: Read Text from a File (Instrukcje: odczytywanie tekstu z pliku). Przykład odczytywania i zapisywania w pliku binarnym można znaleźć w temacie Instrukcje: odczyt i zapis w nowo utworzonym pliku danych.

Parametr FileMode jest określony w wielu konstruktorach dla FileStream, IsolatedStorageFileStreami w Open metodach File i FileInfo do kontrolowania sposobu otwierania pliku.

FileMode parametry określają, czy plik jest zastępowany, tworzony, otwierany lub jego kombinacja. Użyj polecenia Open , aby otworzyć istniejący plik. Aby dołączyć do pliku, użyj polecenia Append. Aby obcinać plik lub utworzyć plik, jeśli nie istnieje, użyj polecenia Create.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Zobacz też