FileMode Enumeración

  • Referencia

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
System.IO.FileSystem.Primitives.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Especifica cómo el sistema operativo debe abrir un archivo.

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
Herencia
Object
ValueType
Enum
FileMode
Atributos
SerializableAttribute ComVisibleAttribute

Campos

Append 6

Abre el archivo si existe y realiza una búsqueda hasta el final del mismo, o crea un archivo nuevo. Requiere el permiso Append. FileMode.Append solo se puede utilizar junto con FileAccess.Write. Al intentar realizar una búsqueda hasta una posición antes del final del archivo se producirá la excepción IOException, se produce un error de cualquier intento de lectura y una excepción NotSupportedException.
Create 2

Especifica que el sistema operativo debe crear un archivo nuevo. Si el archivo ya existe, se sobrescribirá. Requiere el permiso Write. FileMode.Create es equivalente a solicitar que se utilice CreateNew si no existe el archivo y que se utilice Truncate en caso contrario. Si el archivo ya existe pero es un archivo oculto, se produce una excepción UnauthorizedAccessException.
CreateNew 1

Especifica que el sistema operativo debe crear un archivo nuevo. Requiere el permiso Write. Si el archivo ya existe, se produce una excepción IOException.
Open 3

Especifica que el sistema operativo debe abrir un archivo existente. La capacidad de abrir el archivo depende del valor especificado por la enumeración FileAccess. Se desencadena una excepción FileNotFoundException si el archivo no existe.
OpenOrCreate 4

Especifica que el sistema operativo debe abrir un archivo si ya existe; en caso contrario, debe crearse uno nuevo. Si se abre el archivo con FileAccess.Read, se requiere el permiso Read. Si el acceso a archivos es FileAccess.Write, se requiere el permiso Write. Si se abre el archivo con FileAccess.ReadWrite, se requieren los permisos Read y Write.
Truncate 5

Especifica que el sistema operativo debe abrir un archivo existente. Cuando se abre el archivo, debe truncarse el archivo para que su tamaño sea de cero bytes. Requiere el permiso Write. Al intentar leer un archivo abierto con FileMode.Truncate, se produce una excepción ArgumentException.

Ejemplos

El constructor siguiente FileStream abre un archivo existente (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)

Comentarios

Para obtener un ejemplo de cómo crear un archivo y escribir texto en un archivo, vea Cómo: Escribir texto en un archivo. Para obtener un ejemplo de lectura de texto de un archivo, vea Cómo: Leer texto de un archivo. Para obtener un ejemplo de lectura y escritura en un archivo binario, vea Cómo: Leer y escribir en un archivo de datos recién creado.

Un FileMode parámetro se especifica en muchos de los constructores de FileStream, IsolatedStorageFileStreamy en los Open métodos de File y FileInfo para controlar cómo se abre un archivo.

FileMode los parámetros controlan si un archivo se sobrescribe, crea, abre o alguna combinación. Use Open para abrir un archivo existente. Para anexar a un archivo, use Append. Para truncar un archivo o crear un archivo si no existe, use Create.

Se aplica a

Consulte también