File.OpenHandle Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la SafeFileHandle clase con la ruta de acceso, el modo de creación, el permiso de lectura y escritura y uso compartido especificados, el acceso a safeFileHandles puede tener en el mismo archivo, opciones de archivo adicionales y el tamaño de asignación.
public static Microsoft.Win32.SafeHandles.SafeFileHandle OpenHandle (string path, System.IO.FileMode mode = System.IO.FileMode.Open, System.IO.FileAccess access = System.IO.FileAccess.Read, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None, long preallocationSize = 0);static member OpenHandle : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions * int64 -> Microsoft.Win32.SafeHandles.SafeFileHandlePublic Shared Function OpenHandle (path As String, Optional mode As FileMode = System.IO.FileMode.Open, Optional access As FileAccess = System.IO.FileAccess.Read, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None, Optional preallocationSize As Long = 0) As SafeFileHandleParámetros
- path
- String
Ruta de acceso relativa o absoluta para el archivo que la instancia actual SafeFileHandle encapsulará.
- mode
- FileMode
Uno de los valores de enumeración que determina cómo abrir o crear el archivo. El valor predeterminado es Open
- access
- FileAccess
Combinación bit a bit de los valores de enumeración que determina cómo se puede acceder al archivo. El valor predeterminado es Read
- share
- FileShare
Combinación bit a bit de los valores de enumeración que determina cómo los procesos compartirán el archivo. El valor predeterminado es Read.
- options
- FileOptions
Objeto que describe parámetros opcionales SafeFileHandle que se van a usar.
- preallocationSize
- Int64
Tamaño de asignación inicial en bytes para el archivo. Un valor positivo solo es efectivo cuando se crea, sobrescribe o reemplaza un archivo normal. No se permiten valores negativos. En otros casos (incluido el valor predeterminado 0), se omite.
Devoluciones
Instancia de SafeFileHandle.
Excepciones
path es null.
path es una cadena vacía (""), solo contiene espacios en blanco o uno o más caracteres no válidos.
-o bien- path hace referencia a un dispositivo que no es de archivo, como CON:, COM1:, LPT1:, etc. en un entorno NTFS.
path hace referencia a un dispositivo que no es de archivo, como CON:, COM1:, LPT1:etc. en un entorno que no es NTFS.
preallocationSize es negativo.
-o bien- mode, accesso share contienen un valor no válido.
No se encuentra el archivo, como cuando mode es Truncate o Open, y el archivo especificado por path no existe. El archivo ya debe existir en estos modos.
Se ha producido un error de E/S, como cuando se especifica CreateNew cuando el archivo especificado por path ya existe.
-o bien- El disco estaba lleno (cuando preallocationSize se proporcionó y path apuntaba a un archivo normal).
-o bien- El archivo era demasiado grande (cuando preallocationSize se proporcionó y path apuntaba a un archivo normal).
El llamador no dispone del permiso requerido.
La ruta de acceso especificada no es válida, por ejemplo, está en una unidad no asignada.
El sistema operativo no permite el objeto access solicitado para el objeto path especificado, como cuando access es Write o ReadWrite y el archivo o directorio está establecido para el acceso de solo lectura.
-o bien- Encrypted se especifica para options, pero el cifrado de archivos no se admite en la plataforma actual.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
