FileSystem.FileGet 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.
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
Sobrecargas
| Name | Description |
|---|---|
| FileGet(Int32, Array, Int64, Boolean, Boolean) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, String, Int64, Boolean) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, ValueType, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Single, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Int64, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Int32, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Decimal, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Double, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, DateTime, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Char, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Byte, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Boolean, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
| FileGet(Int32, Int16, Int64) |
Lê dados de um ficheiro de disco aberto para uma variável. A |
FileGet(Int32, Array, Int64, Boolean, Boolean)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref Array Value, long RecordNumber = -1, bool ArrayIsDynamic = false, bool StringIsFixedLength = false);
static member FileGet : int * Array * int64 * bool * bool -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Array, Optional RecordNumber As Long = -1, Optional ArrayIsDynamic As Boolean = false, Optional StringIsFixedLength As Boolean = false)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Array
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
- ArrayIsDynamic
- Boolean
Optional. Aplica-se apenas ao escrever um array. Especifica se o array deve ser tratado como dinâmico e se é necessário um descritor de array que descreva o tamanho e os limites do array.
- StringIsFixedLength
- Boolean
Optional. Aplica-se apenas ao escrever uma string. Especifica se deve escrever um descritor de dois bytes para a cadeia que descreve o comprimento. A predefinição é False.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, String, Int64, Boolean)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref string Value, long RecordNumber = -1, bool StringIsFixedLength = false);
static member FileGet : int * string * int64 * bool -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As String, Optional RecordNumber As Long = -1, Optional StringIsFixedLength As Boolean = false)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- String
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
- StringIsFixedLength
- Boolean
Optional. Aplica-se apenas ao escrever uma string. Especifica se deve escrever um descritor de dois bytes para a cadeia que descreve o comprimento. A predefinição é False.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, ValueType, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref ValueType Value, long RecordNumber = -1);
static member FileGet : int * ValueType * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As ValueType, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- ValueType
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Single, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref float Value, long RecordNumber = -1);
static member FileGet : int * single * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Single, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Single
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Int64, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref long Value, long RecordNumber = -1);
static member FileGet : int * int64 * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Long, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Int64
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Int32, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref int Value, long RecordNumber = -1);
static member FileGet : int * int * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Integer, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Int32
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Decimal, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref decimal Value, long RecordNumber = -1);
static member FileGet : int * decimal * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Decimal, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Decimal
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Double, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref double Value, long RecordNumber = -1);
static member FileGet : int * double * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Double, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Double
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, DateTime, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref DateTime Value, long RecordNumber = -1);
static member FileGet : int * DateTime * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As DateTime, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- DateTime
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Char, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref char Value, long RecordNumber = -1);
static member FileGet : int * char * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Char, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Char
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Byte, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref byte Value, long RecordNumber = -1);
static member FileGet : int * byte * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Byte, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Byte
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado. Depois, o tamanho e os limites do array passaram aFileGetdeterminar o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Boolean, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref bool Value, long RecordNumber = -1);
static member FileGet : int * bool * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Boolean, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Boolean
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic
Aplica-se a
FileGet(Int32, Int16, Int64)
Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.
public static void FileGet(int FileNumber, ref short Value, long RecordNumber = -1);
static member FileGet : int * int16 * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Short, Optional RecordNumber As Long = -1)
Parâmetros
- FileNumber
- Int32
Required. Qualquer número de ficheiro válido.
- Value
- Int16
Required. Nome válido da variável em que os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.
Exceções
RecordNumber
< 1 e não é igual a -1.
O modo ficheiro é inválido.
Observações
FileGet é válido apenas em Random modo e Binary .
Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.
O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.
Importante
Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.
Modo Aleatório
Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:
Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.Por defeito, se a variável em que se lia for uma cadeia,
FileGetlê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passarTruepara oStringIsFixedLengthparâmetro, e a cadeia em que leste deve ter o comprimento correto.Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o
ArrayIsDynamicparâmetro paraTrue. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passadosFileGetdeterminam o que ler.O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo
RecordLengthparâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.Dim MyArray(4, 9) As IntegerOs 218 bytes estão distribuídos da seguinte forma:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto),
FileGetapenas lê os dados da variável. O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados a serem lidos.FileGetlê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito comFilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelaRecordLengthcláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isto inclui quaisquer arrays e os seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.
Modo Binário
Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.Para qualquer array que não seja um array numa estrutura,
FileGetlê apenas os dados. Não é lido qualquer descritor.FileGetlê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.Importante
Ler a partir de um ficheiro usando a
FileGetfunção requerReadacesso a partir da FileIOPermissionAccess enumeração.
Ver também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- A ler a partir de ficheiros em Visual Basic
- Escrita em ficheiros em Visual Basic