Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

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
Tipo: System.String
Ruta relativa o absoluta del archivo que va a encapsular el objeto FileStream actual.
mode
Tipo: System.IO.FileMode
Constante que determina cómo abrir o crear el archivo.
rights
Tipo: 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
Tipo: System.IO.FileShare
Constante que determina cómo compartirán el archivo los procesos.
bufferSize
Tipo: System.Int32
Valor Int32 positivo mayor que 0 que indica el tamaño del búfer. Para valores de bufferSize entre uno y ocho, el tamaño de búfer real se establece en ocho bytes.
options
Tipo: System.IO.FileOptions
Constante que especifica opciones de archivo adicionales.

ExcepciónCondición
ArgumentNullException

path es null.

ArgumentException

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

O bien

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 que no es 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 no existe el archivo especificado por path. El archivo ya debe existir en estos modos.

PlatformNotSupportedException

El sistema operativo actual no es Windows NT o una versión posterior.

IOException

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

O bien

Se ha cerrado la secuencia.

SecurityException

El llamador no dispone del permiso requerido.

DirectoryNotFoundException

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

UnauthorizedAccessException

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

O bien

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

PathTooLongException

El valor especificado para path, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, las rutas de acceso deben ser inferiores a 248 caracteres y los nombres de archivo deben ser inferiores a 260 caracteres.

.NET Framework no admite el acceso directo a los discos físicos a través de las rutas que son nombres de dispositivos, como “\PHYSI CALDRIVE0 del \\.”.

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

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

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

NotaNota

No es necesario que path sea un archivo almacenado en disco; puede formar parte de un sistema que admita el acceso a través de secuencias. Por ejemplo, dependiendo del sistema, esta clase podrá tener acceso a un dispositivo físico.

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

Nota de precauciónPrecaución

Cuando se compila un conjunto de caracteres con una configuración de referencia cultural concreta y se recuperan los mismos caracteres con una configuración de referencia cultural diferente, es posible que los caracteres no se puedan interpretar y podría producirse una excepción.

Para obtener una lista de operaciones de archivo comunes y directorio, vea Tareas de E/S comunes.

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft