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

 

Publicado: octubre de 2016

Nota: Esta API ahora está obsoleta.

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

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

[ObsoleteAttribute("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream(
	IntPtr handle,
	FileAccess access,
	bool ownsHandle,
	int bufferSize,
	bool isAsync
)

Parámetros

handle
Type: System.IntPtr

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.

ownsHandle
Type: System.Boolean

Es true si esta instancia de FileStream va a ser la propietaria del identificador de archivo; en caso contrario, es false.

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
ArgumentOutOfRangeException

access es menor que FileAccess.Read o mayor que FileAccess.ReadWrite o bufferSize es menor o igual que 0.

ArgumentException

El identificador no es válido.

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.

La FileStream objeto se asigna el acceso especificado al archivo. La propiedad del identificador será como se especifica. Si este FileStream posee el identificador, una llamada a la Close método también cerrará el identificador. En particular, el recuento de identificadores del archivo es reducido. El FileStream se proporciona el tamaño de búfer especificado al objeto.

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.

SecurityPermission

for access to unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode.

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: