FileSystem.FileGet Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.

Sobrecargas

FileGet(Int32, Array, Int64, Boolean, Boolean)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, String, Int64, Boolean)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, ValueType, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Single, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Int64, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Int32, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Decimal, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Double, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, DateTime, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Char, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Byte, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Boolean, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.
FileGet(Int32, Int16, Int64)	Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que FileGet. Para obter mais informações, consulte FileSystem.

FileGet(Int32, Array, Int64, Boolean, Boolean)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Array

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

ArrayIsDynamic

Boolean

Opcional. Aplica-se somente ao gravar uma matriz. Especifica se a matriz deve ser tratada como dinâmica e se é necessário um descritor de matriz que descreve o tamanho e limites da matriz.

StringIsFixedLength

Boolean

Opcional. Aplica-se somente ao gravar uma cadeia de caracteres. Especifica se deve gravar um descritor de dois bytes para a cadeia de caracteres que descreve o tamanho. O padrão é False.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 RecordLength cláusula da FileOpen função, FileGet lerá 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 é preenchido com o conteúdo existente do buffer de arquivos. 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, FileGet lerá 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 pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres em que você leu deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi gravada. 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 passados para FileGet determinarão 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 RecordLength registro especificado pelo parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do RecordLength registro especificado pela cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do RecordLength registro especificado pela cláusula na FileOpen funçã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. O VBFixedString atributo 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 Random maioria das regras de modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:

• A cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz que não seja uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres que já estão na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, String, Int64, Boolean)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

String

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

StringIsFixedLength

Boolean

Opcional. Aplica-se somente ao gravar uma cadeia de caracteres. Especifica se deve gravar um descritor de dois bytes para a cadeia de caracteres que descreve o tamanho. O padrão é False.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 RecordLength cláusula da FileOpen função, FileGet lerá 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 é preenchido com o conteúdo existente do buffer de arquivos. 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, FileGet lerá 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 pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres em que você leu deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi gravada. 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 passados para FileGet determinarão 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 RecordLength registro especificado pelo parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do RecordLength registro especificado pela cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do RecordLength registro especificado pela cláusula na FileOpen funçã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. O VBFixedString atributo 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 Random maioria das regras de modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:

• A cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz que não seja uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres que já estão na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, ValueType, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

ValueType

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 RecordLength cláusula da FileOpen função, FileGet lerá 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 é preenchido com o conteúdo existente do buffer de arquivos. 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, FileGet lerá 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 pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres em que você leu deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi gravada. 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 passados para FileGet determinarão 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 RecordLength registro especificado pelo parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do RecordLength registro especificado pela cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do RecordLength registro especificado pela cláusula na FileOpen funçã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. O VBFixedString atributo 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 Random maioria das regras de modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:

• A cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz que não seja uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres que já estão na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Single, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Single

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 RecordLength cláusula da FileOpen função, FileGet lerá 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 é preenchido com o conteúdo existente do buffer de arquivos. 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, FileGet lerá 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 pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres em que você leu deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi gravada. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Int64, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Int64

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Int32, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Int32

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Decimal, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Decimal

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Double, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Double

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando aFileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, DateTime, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

DateTime

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Os dados lidos com FileGet geralmente são gravados em um arquivo com FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função,FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Char, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Char

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Os dados lidos com FileGet geralmente são gravados em um arquivo com FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Byte, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Byte

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Os dados lidos com FileGet geralmente são gravados em um arquivo com FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado. Em seguida, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Boolean, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Boolean

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Os dados lidos com FileGet geralmente são gravados em um arquivo com FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 do que o comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lerá os registros subsequentes em limites de comprimento de registro. O espaço entre o final de um registro e o início do próximo registro é preenchido 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 é uma cadeia de caracteres, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia de caracteres e lê os dados que vão para a variável. Portanto, o comprimento do registro especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres que você ler deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi escrita. Se ele tiver sido escrito com o descritor, você precisará ler o descritor. Se o descritor não for usado, o tamanho e os limites da matriz passados para FileGet determinar 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 registro especificado pelo RecordLength parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do registro especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do registro especificado pela RecordLength cláusula na FileOpen funçã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. O VBFixedString atributo 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 cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz diferente de uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres já na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando aFileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic

FileGet(Int32, Int16, Int64)

Origem:

FileSystem.vb

Lê dados de um arquivo aberto de disco em uma variável. O recurso My oferece melhor produtividade e desempenho em operações de E/S do 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

Obrigatórios. Qualquer número de arquivo válido.

Value

Int16

Obrigatórios. Nome de variável válido no qual os dados são lidos.

RecordNumber

Int64

Opcional. Registre o número (arquivos de modo Random) ou número de byte (arquivos de modo Binary) no qual a leitura começa.

Exceções

ArgumentException

RecordNumber< 1 e não é igual a -1.

IOException

O modo de arquivo é inválido.

Comentários

FileGet é válido somente no Random modo e Binary .

Dados lidos com FileGet costumam ser gravados em um arquivo usando-se FilePut.

O primeiro registro ou byte em um arquivo está na posição 1, o segundo registro ou byte está na posição 2 e assim por diante. Se você omitir RecordNumber, o próximo registro ou byte após a última FileGet função ou FilePut (ou apontado pela última Seek função) será lido.

Importante

Ao ler de 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 chamado Form1.vb pode não ser um arquivo de origem do 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 RecordLength cláusula da FileOpen função, FileGet lerá 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 é preenchido com o conteúdo existente do buffer de arquivos. 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, FileGet lerá 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 pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior que o comprimento real da cadeia de caracteres. O Visual Basic 6.0 e versões anteriores dão suporte a cadeias de caracteres de comprimento fixo; quando colocado em um arquivo, o descritor de comprimento não é gravado. Se você quiser ler uma cadeia de caracteres sem o descritor, deverá passar True para o StringIsFixedLength parâmetro e a cadeia de caracteres em que você leu deve ter 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 ArrayIsDynamic parâmetro como True. Ao ler a matriz, você precisa corresponder à maneira como a matriz foi gravada. 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 passados para FileGet determinarão 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 RecordLength registro especificado pelo parâmetro na FileOpen funçã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 Integer
  

  Os 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), FileGet lerá apenas os dados da variável. O comprimento do RecordLength registro especificado pela cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados que estão sendo lidos.

• FileGet lê 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 com FilePut) é prefixada por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NumberOfDimensions). O comprimento do RecordLength registro especificado pela cláusula na FileOpen funçã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. O VBFixedString atributo 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 Random maioria das regras de modo se aplicam, com algumas exceções. As seguintes regras para arquivos abertos no Binary modo diferem das regras para Random o modo:

• A cláusula RecordLength na função de FileOpen não está em vigor. FileGet lê todas as variáveis do disco contíguamente; ou seja, sem preenchimento entre registros.

• Para qualquer matriz que não seja uma matriz em uma estrutura, FileGet lê apenas os dados. Nenhum descritor é lido.

• FileGet lê 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 caracteres que já estão na cadeia de caracteres.

  Importante

  A leitura de um arquivo usando a FileGet função requer Read acesso da FileIOPermissionAccess enumeração .

Confira também

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Lendo a partir de arquivos no Visual Basic
• Gravando em arquivos no Visual Basic