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 (SafeFileHandle, FileAccess, Int32, Boolean)

 

Publicado: octubre de 2016

Inicializa una nueva instancia de la clase FileStream para el identificador de archivo especificado, y con el permiso de lectura y escritura, el tamaño de búfer y el estado sincrónico o asincrónico especificados.

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

public FileStream(
	SafeFileHandle handle,
	FileAccess access,
	int bufferSize,
	bool isAsync
)

Parámetros

handle
Type: Microsoft.Win32.SafeHandles.SafeFileHandle

Identificador de archivo para el archivo que este objeto FileStream va a encapsular.

access
Type: System.IO.FileAccess

Constante que establece las propiedades CanRead y CanWrite del objeto FileStream.

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.

isAsync
Type: System.Boolean

Es true si se abrió el identificador de forma asincrónica (es decir, en modo de E/S superpuesta); de lo contrario, es false.

Exception Condition
ArgumentException

El parámetro handle tiene un identificador que no es válido.

-o-

El parámetro handle es un identificador sincrónico y se usó de forma asincrónica.

ArgumentOutOfRangeException

El parámetro bufferSize es negativo.

IOException

Se produjo un error de E/S, como un error de disco.

-o-

Se ha cerrado la secuencia.

SecurityException

El llamador no dispone del permiso requerido.

UnauthorizedAccessException

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

Establece el isAsync parámetro true para abrir el identificador de archivo de forma asincrónica. Cuando el parámetro es true, la secuencia utiliza E/S superpuesta para realizar operaciones de archivo de forma asincrónica. Sin embargo, el parámetro no tiene que ser true para llamar a la ReadAsync, WriteAsync, o CopyToAsync (método). Cuando el isAsync parámetro es false y llamar a la lectura asincrónica y las operaciones de escritura, todavía no bloquean el subproceso de la interfaz de usuario, pero la operación de E/S real se realiza de forma sincrónica.

FileStream se supone que tiene control exclusivo sobre el identificador. Lectura, escritura o búsqueda mientras un FileStream contiene también un identificador podría provocar daños en los datos. Para la seguridad de los datos, llame a Flush antes de utilizar el identificador y evite llamar a cualquier método que no sea Close cuando haya terminado con el identificador. Como alternativa, lectura y escritura en el controlador antes de llamar a este FileStream constructor.

FileShare.Read es el valor predeterminado para los FileStream constructores sin un FileShare parámetro.

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.

SecurityPermission

for permission to call unmanaged code. Associated enumerations: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: