FileSystem.FileGet Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
Sobrecargas
| Nome | Description |
|---|---|
| FileGet(Int32, Array, Int64, Boolean, Boolean) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, String, Int64, Boolean) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, ValueType, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Single, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Int64, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Int32, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Decimal, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Double, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, DateTime, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Char, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Byte, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Boolean, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
| FileGet(Int32, Int16, Int64) |
Lê dados de um arquivo de disco aberto em uma variável. O |
FileGet(Int32, Array, Int64, Boolean, Boolean)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Array
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
- ArrayIsDynamic
- Boolean
Optional. Aplica-se somente ao escrever uma matriz. Especifica se a matriz deve ser tratada como dinâmica e se um descritor de matriz que descreve o tamanho e os limites da matriz é necessário.
- StringIsFixedLength
- Boolean
Optional. Aplica-se somente ao escrever uma cadeia de caracteres. Especifica se um descritor de dois bytes deve ser gravado para a cadeia de caracteres que descreve o comprimento. O padrão é False.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, String, Int64, Boolean)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- String
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
- StringIsFixedLength
- Boolean
Optional. Aplica-se somente ao escrever uma cadeia de caracteres. Especifica se um descritor de dois bytes deve ser gravado para a cadeia de caracteres que descreve o comprimento. O padrão é False.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, ValueType, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- ValueType
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Single, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Single
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Int64, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Int64
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Int32, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Int32
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Decimal, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Decimal
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Double, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Double
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, DateTime, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- DateTime
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Char, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Char
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Byte, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Byte
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado. Em seguida, o tamanho e os limites da matriz passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Boolean, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Boolean
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic
Aplica-se a
FileGet(Int32, Int16, Int64)
Lê dados de um arquivo de disco aberto em uma variável. O My recurso oferece melhor produtividade e desempenho em operações de E/S de arquivo do que FileGet. Para obter mais informações, consulte 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 arquivo válido.
- Value
- Int16
Required. Nome de variável válido no qual os dados são lidos.
- RecordNumber
- Int64
Optional. Número de registro (Random arquivos de modo) ou número de byte (Binary arquivos de modo) no qual a leitura é iniciada.
Exceções
RecordNumber
< 1 e não igual a -1.
O modo de arquivo é inválido.
Comentários
FileGeté válido somente no modo e Binary no Random modo.
Os dados lidos geralmente FileGet são gravados em um arquivo 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 você omitir RecordNumber, o próximo registro ou byte após a última FileGet ou FilePut função (ou apontado pela última Seek função) será lido.
Importante
Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.
Modo Aleatório
Para arquivos abertos no Random modo, as seguintes regras se aplicam:
Se o comprimento dos dados que estão sendo lidos for menor que o comprimento especificado na
RecordLengthcláusula daFileOpenfunção,FileGetlerá os registros subsequentes nos limites de comprimento do registro. O espaço entre o final de um registro e o início do próximo registro é adicionado com o conteúdo existente do buffer de arquivo. Como a quantidade de dados de preenchimento não pode ser determinada com certeza, geralmente é uma boa ideia fazer com que o comprimento do registro corresponda ao comprimento dos dados que estão sendo lidos.Por padrão, se a variável que está sendo lida for uma cadeia de caracteres,
FileGetlerá um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lerá os dados que vão para a variável. Portanto, o comprimento do registro especificado pelaRecordLengthcláusula daFileOpenfunção deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocadas em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passarTruepara oStringIsFixedLengthparâmetro e a cadeia de caracteres na qual você leu deve ser o comprimento correto.Se a variável que está sendo lida for uma matriz, você poderá escolher se deseja ler um descritor para o tamanho e a dimensão da matriz. Para gravar o descritor, defina o
ArrayIsDynamicparâmetro comoTrue. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele foi escrito com o descritor, você precisa ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz serão passados paraFileGetdeterminar o que ler.O descritor especifica a classificação da matriz, o tamanho e os limites inferiores para cada classificação. Seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do
RecordLengthregistro especificado pelo parâmetro naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para gravar os dados da matriz e o descritor da matriz. Por exemplo, a declaração de matriz a seguir requer 218 bytes quando a matriz é gravada em disco.Dim MyArray(4, 9) As IntegerOs 218 bytes são distribuídos da seguinte maneira:
18 bytes para o descritor: (2 + 8 * 2)
200 bytes para os dados: (5 * 10 * 4).
Se a variável que está sendo lida for qualquer outro tipo de variável (não uma cadeia de caracteres de comprimento variável ou um objeto),
FileGetlerá apenas os dados da variável. O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.FileGetlê elementos de estruturas como se cada um estivesse sendo lido individualmente, exceto que não há preenchimento entre elementos. No disco, uma matriz dinâmica em um tipo definido pelo usuário (escrito comFilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento doRecordLengthregistro especificado pela cláusula naFileOpenfunção deve ser maior ou igual à soma de todos os bytes necessários para ler os elementos individuais. Isso inclui todas as matrizes e seus descritores. OVBFixedStringatributo pode ser aplicado a campos de cadeia de caracteres nas estruturas para indicar o tamanho de uma cadeia de caracteres quando gravado em disco.
Modo binário
Para arquivos abertos no Binary modo, a maioria das regras de Random modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:
A
RecordLengthcláusula naFileOpenfunção não tem efeito.FileGetlê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.Para qualquer matriz diferente de uma matriz em uma estrutura,
FileGetlê apenas os dados. Não é lido nenhum descritor.FileGetlê cadeias de caracteres 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 carateres já existentes na cadeia.Importante
A leitura de um arquivo usando a
FileGetfunção requerReadacesso da FileIOPermissionAccess enumeração.
Confira também
- FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
- FilePut
- Seek
- FileGetObject(Int32, Object, Int64)
- Reading from Files in Visual Basic
- Writing to Files in Visual Basic