File.OpenHandle Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicializa uma nova instância da SafeFileHandle classe com o caminho especificado, modo de criação, permissão de leitura/escrita e partilha, o acesso que outros SafeFileHandles podem ter ao mesmo ficheiro, opções adicionais de ficheiro e o tamanho da alocação.
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
Um caminho relativo ou absoluto para o ficheiro que a instância atual SafeFileHandle irá encapsular.
- mode
- FileMode
Um dos valores de enumeração que determina como abrir ou criar o ficheiro. O valor predefinido é Open
- access
- FileAccess
Uma combinação bit a bit dos valores de enumeração que determina como o ficheiro pode ser acedido. O valor predefinido é Read
- share
- FileShare
Uma combinação bit a bit dos valores de enumeração que determina como o ficheiro será partilhado pelos processos. O valor predefinido é Read.
- options
- FileOptions
Um objeto que descreve parâmetros opcionais SafeFileHandle a usar.
- preallocationSize
- Int64
O tamanho inicial da alocação em bytes para o ficheiro. Um valor positivo só é eficaz quando um ficheiro normal está a ser criado, sobrescrito ou substituído. Valores negativos não são permitidos. Noutros casos (incluindo o valor 0 padrão), é ignorado.
Devoluções
Um SafeFileHandle exemplo.
Exceções
path é null.
path é uma cadeia vazia (""), contém apenas espaço em branco, ou contém um ou mais caracteres inválidos.
-ou- path refere-se a um dispositivo que não seja de ficheiro, como CON:, COM1:, LPT1:, etc., num ambiente NTFS.
path refere-se a um dispositivo que não seja de ficheiro, como CON:, COM1:, LPT1:, etc., num ambiente não NTFS.
preallocationSize é negativo.
-ou- mode, access, ou share conter um valor inválido.
O ficheiro não pode ser encontrado, como quando mode é Truncate ou Open, e o ficheiro especificado por path não existe. O ficheiro deve já existir nestes modos.
Ocorreu um erro de E/S, como especificar CreateNew quando o ficheiro especificado por path já existe.
-ou- O disco estava cheio (quando preallocationSize fornecido e path apontava para um ficheiro normal).
-ou- O ficheiro era demasiado grande (quando preallocationSize foi fornecido e path apontava para um ficheiro normal).
O interlocutor não tem a permissão necessária.
O caminho especificado é inválido, como se estivesse num disco não mapeado.
O access pedido não é permitido pelo sistema operativo para o especificado path, como quando access é Write ou ReadWrite e o ficheiro ou diretório está definido para acesso apenas de leitura.
-ou- Encrypted é especificado para options, mas a encriptação de ficheiros não é suportada na plataforma atual.
O caminho especificado, nome do ficheiro ou ambos excedem o comprimento máximo definido pelo sistema.
