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

Append 6

Otwiera plik, jeśli istnieje i szuka końca pliku lub tworzy nowy plik. Append Wymaga to uprawnień. FileMode.Appendmożna używać tylko w połączeniu z .FileAccess.Write Próba uzyskania 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.Create jest odpowiednikiem żądania, że jeśli plik nie istnieje, użyj polecenia ; w przeciwnym razie użyj CreateNewpolecenia 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ść otwarcia pliku zależy od wartości określonej przez FileAccess wyliczenie. Wyjątek FileNotFoundException jest zgłaszany, jeśli plik nie istnieje.
OpenOrCreate 4

Określa, że system operacyjny powinien otworzyć plik, jeśli istnieje; w przeciwnym razie należy utworzyć nowy plik. Jeśli plik zostanie 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 zostanie otwarty za pomocą FileAccess.ReadWritepolecenia , zarówno, jak Read i Write uprawnienia są wymagane.
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óbuje odczytać plik otwarty z FileMode.Truncate powodu wyjątku ArgumentException .

Przykłady

FileStream Poniższy 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). Aby zapoznać się z przykładem odczytywania tekstu z pliku, zobacz Instrukcje: odczytywanie tekstu z pliku. Aby zapoznać się z przykładem odczytywania i zapisywania w pliku binarnym, zobacz 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, czy też niektóre z nich. Użyj Open polecenia , 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

Zobacz też