Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Constructor FileStream (String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

 

Publicado: octubre de 2016

Inicializa una nueva instancia de la clase FileStream con la ruta de acceso, el modo de creación, los derechos de acceso y el permiso de uso compartido, el tamaño de búfer y opciones de archivo adicionales que se hayan especificado.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

public FileStream(
	string path,
	FileMode mode,
	FileSystemRights rights,
	FileShare share,
	int bufferSize,
	FileOptions options
)

Parámetros

path
Type: System.String

Ruta de acceso relativa o absoluta del archivo que va a encapsular el objeto FileStream actual.

mode
Type: System.IO.FileMode

Constante que determina cómo abrir o crear el archivo.

rights
Type: System.Security.AccessControl.FileSystemRights

Constante que determina los derechos de acceso que se emplean al crear reglas de acceso y auditoría para el archivo.

share
Type: System.IO.FileShare

Constante que determina cómo compartirán el archivo los procesos.

bufferSize
Type: System.Int32

Valor Int32 positivo mayor que 0 que indica el tamaño del búfer. El tamaño de búfer predeterminado es 4096.

options
Type: System.IO.FileOptions

Constante que especifica opciones de archivo adicionales.

Exception Condition
ArgumentNullException

El valor de path es null.

ArgumentException

path es una cadena vacía (""), solo contiene espacios en blanco o contiene uno o más caracteres no válidos.

-o-

path hace referencia a un dispositivo que no es un archivo, como "con:", "com1:", "lpt1:", etc. en un entorno NTFS.

NotSupportedException

path hace referencia a un dispositivo que no es un archivo, como "con:", "com1:", "lpt1:", etc. en un entorno distinto de NTFS.

ArgumentOutOfRangeException

bufferSize es un valor negativo o es cero.

O bien

mode, access o share contienen un valor no válido.

FileNotFoundException

No se encuentra el archivo, como cuando mode es FileMode.Truncate o FileMode.Open, y el archivo especificado por path no existe. El archivo ya debe existir en estos modos.

PlatformNotSupportedException

El sistema operativo actual no es Windows NT o posterior.

IOException

Se ha producido un error de E/S, como cuando se especifica FileMode.CreateNew cuando el archivo especificado por path ya existe.

-o-

Se ha cerrado la secuencia.

SecurityException

El llamador no dispone del permiso requerido.

DirectoryNotFoundException

La ruta de acceso especificada no es válida, porque, por ejemplo, está en una unidad no asignada.

UnauthorizedAccessException

El access solicitado no está permitido por el sistema operativo para el path especificado, como cuando access es Write o ReadWrite y el archivo o directorio está establecido para el acceso de solo lectura.

-o-

Encrypted se ha especificado para options, pero no se admite el cifrado de archivos en la plataforma actual.

PathTooLongException

La path especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas de acceso deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.

.NET Framework no admite el acceso directo a discos físicos a través de rutas de acceso que sean nombres de dispositivo, como "\\.\PHYSICALDRIVE0".

Utilice esta FileStream derechos de constructor para aplicar el acceso en el momento de creación de un archivo. Para obtener acceso o modificar los derechos en un archivo existente, considere el uso de la GetAccessControl y SetAccessControl métodos.

El fileOptions parámetro se utiliza para proporcionar acceso a operaciones más avanzadas que se pueden aprovechar al crear un FileStream objeto.

El path parámetro puede ser un nombre de archivo, incluido un archivo en un recurso compartido de convención de nomenclatura Universal (UNC).

System_CAPS_noteNota

path no es necesario que sea un archivo almacenado en disco; puede ser cualquier parte de un sistema que admita el acceso a través de secuencias. Por ejemplo, dependiendo del sistema, esta clase puede acceder a un dispositivo físico.

CanSeek es true para todos los FileStream objetos que encapsulan archivos. Si path indica un dispositivo que no admite la búsqueda, el CanSeek propiedad resultante FileStream es false. Para obtener información adicional, vea CanSeek.

System_CAPS_cautionPrecaución

Cuando se compile un juego de caracteres con una configuración cultural concreta y se recuperan los mismos caracteres con una configuración cultural diferente, los caracteres no pueden interpretarse y podrían provocar que se produzca una excepción.

Para obtener una lista de operaciones de directorio y de archivo común, consulte Tareas de E/S comunes.

FileIOPermission

for reading, writing, and appending to files. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write, and F:System.Security.Permissions.FileIOPermissionAccess.Append.

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: