FileSystem.FileGet Método

Definição

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

Sobrecargas

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

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, String, Int64, Boolean)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, ValueType, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Single, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Int64, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Int32, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Decimal, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Double, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, DateTime, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Char, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Byte, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Boolean, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

FileGet(Int32, Int16, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

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

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref Array Value, long RecordNumber = -1, bool ArrayIsDynamic = false, bool StringIsFixedLength = false);
static member FileGet : int * Array * int64 * bool * bool -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Array, Optional RecordNumber As Long = -1, Optional ArrayIsDynamic As Boolean = false, Optional StringIsFixedLength As Boolean = false)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Array

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

ArrayIsDynamic
Boolean

Optional. Aplica-se apenas ao escrever um array. Especifica se o array deve ser tratado como dinâmico e se é necessário um descritor de array que descreva o tamanho e os limites do array.

StringIsFixedLength
Boolean

Optional. Aplica-se apenas ao escrever uma string. Especifica se deve escrever um descritor de dois bytes para a cadeia que descreve o comprimento. A predefinição é False.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, String, Int64, Boolean)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref string Value, long RecordNumber = -1, bool StringIsFixedLength = false);
static member FileGet : int * string * int64 * bool -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As String, Optional RecordNumber As Long = -1, Optional StringIsFixedLength As Boolean = false)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
String

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

StringIsFixedLength
Boolean

Optional. Aplica-se apenas ao escrever uma string. Especifica se deve escrever um descritor de dois bytes para a cadeia que descreve o comprimento. A predefinição é False.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, ValueType, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref ValueType Value, long RecordNumber = -1);
static member FileGet : int * ValueType * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As ValueType, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
ValueType

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Single, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref float Value, long RecordNumber = -1);
static member FileGet : int * single * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Single, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Single

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Int64, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref long Value, long RecordNumber = -1);
static member FileGet : int * int64 * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Long, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Int64

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Int32, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref int Value, long RecordNumber = -1);
static member FileGet : int * int * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Integer, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Int32

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Decimal, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref decimal Value, long RecordNumber = -1);
static member FileGet : int * decimal * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Decimal, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Decimal

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Double, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref double Value, long RecordNumber = -1);
static member FileGet : int * double * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Double, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Double

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando aFileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, DateTime, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref DateTime Value, long RecordNumber = -1);
static member FileGet : int * DateTime * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As DateTime, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
DateTime

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função,FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Char, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref char Value, long RecordNumber = -1);
static member FileGet : int * char * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Char, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Char

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Byte, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref byte Value, long RecordNumber = -1);
static member FileGet : int * byte * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Byte, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Byte

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado. Depois, o tamanho e os limites do array passaram a FileGet determinar o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Boolean, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref bool Value, long RecordNumber = -1);
static member FileGet : int * bool * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Boolean, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Boolean

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro com FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando aFileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a

FileGet(Int32, Int16, Int64)

Lê dados de um ficheiro de disco aberto para uma variável. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que FileGet. Para obter mais informações, veja FileSystem.

public static void FileGet(int FileNumber, ref short Value, long RecordNumber = -1);
static member FileGet : int * int16 * int64 -> unit
Public Sub FileGet (FileNumber As Integer, ByRef Value As Short, Optional RecordNumber As Long = -1)

Parâmetros

FileNumber
Int32

Required. Qualquer número de ficheiro válido.

Value
Int16

Required. Nome válido da variável em que os dados são lidos.

RecordNumber
Int64

Optional. Número de registo (Random ficheiros modo) ou número de byte (Binary ficheiros modo) onde a leitura começa.

Exceções

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

O modo ficheiro é inválido.

Observações

FileGet é válido apenas em Random modo e Binary .

Os dados lidos com FileGet são normalmente escritos num ficheiro usando FilePut.

O primeiro registo ou byte num ficheiro está na posição 1, o segundo registo ou byte está na posição 2, e assim sucessivamente. Se omitir RecordNumber, o próximo registo ou byte após o último FileGet ou FilePut função (ou apontado pela última Seek função) é lido.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

Modo Aleatório

Para ficheiros abertos no Random modo, aplicam-se as seguintes regras:

  • Se o comprimento dos dados a ser lidos for inferior ao comprimento especificado na RecordLength cláusula da FileOpen função, FileGet lê registos subsequentes nas fronteiras do comprimento do registo. O espaço entre o fim de um registo e o início do registo seguinte é preenchido com o conteúdo existente do buffer de ficheiros. Como a quantidade de dados de enchimento não pode ser determinada com certeza, é geralmente uma boa ideia que o comprimento do registo coincida com o comprimento dos dados a serem lidos.

  • Por defeito, se a variável em que se lia for uma cadeia, FileGet lê um descritor de dois bytes que contém o comprimento da cadeia e depois lê os dados que entram na variável. Portanto, o comprimento do registo especificado pela RecordLength cláusula da FileOpen função deve ser pelo menos dois bytes maior do que o comprimento real da cadeia. O Visual Basic 6.0 e versões anteriores suportam strings de comprimento fixo; quando colocado num ficheiro, o descritor de comprimento não é escrito. Se quiseres ler uma cadeia sem o descriptor, deves passar True para o StringIsFixedLength parâmetro, e a cadeia em que leste deve ter o comprimento correto.

  • Se a variável em que se lia for um array, pode escolher se quer ler um descritor para o tamanho e dimensão do array. Para escrever o descritor, defina o ArrayIsDynamic parâmetro para True. Ao ler o array, tens de corresponder à forma como o array foi escrito. Se foi escrito com o descriptor, tens de ler o descriptor. Se o descritor não for utilizado, o tamanho e os limites do array passados FileGet determinam o que ler.

    O descritor especifica o posto do array, o tamanho e os limites inferiores para cada rank. O seu comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado pelo RecordLength parâmetro na FileOpen função deve ser maior ou igual à soma de todos os bytes necessários para escrever os dados do array e o descritor do array. Por exemplo, a seguinte declaração do array requer 218 bytes quando o array é escrito no disco.

    Dim MyArray(4, 9) As Integer
    

    Os 218 bytes estão distribuídos da seguinte forma:

    • 18 bytes para o descritor: (2 + 8 * 2)

    • 200 bytes para os dados: (5 * 10 * 4).

  • Se a variável em que se é lida for qualquer outro tipo de variável (não uma cadeia de comprimento variável ou um objeto), FileGet apenas lê os dados da variável. O comprimento do registo especificado pela RecordLength cláusula na FileOpen função deve ser maior ou igual ao comprimento dos dados a serem lidos.

  • FileGet lê elementos das estruturas como se cada um estivesse a ser lido individualmente, exceto que não há preenchimento entre elementos. No disco, um array dinâmico num tipo definido pelo utilizador (escrito com FilePut) é precedido por um descritor cujo comprimento é igual a 2 mais 8 vezes o número de dimensões: (2 + 8 * NúmeroDeDimensões). O comprimento do registo especificado 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. Isto inclui quaisquer arrays e os seus descritores. O VBFixedString atributo pode ser aplicado a campos de cadeia nas estruturas para indicar o tamanho de uma cadeia quando escrita no disco.

Modo Binário

Para ficheiros abertos no Binary modo, a maioria das Random regras do modo aplica-se, com algumas exceções. As seguintes regras para ficheiros abertos no Binary modo diferem das regras do Random modo:

  • A RecordLength cláusula na FileOpen função não tem efeito. FileGet lê todas as variáveis do disco de forma contígua; ou seja, sem preenchimento entre discos.

  • Para qualquer array que não seja um array numa estrutura, FileGet lê apenas os dados. Não é lido qualquer descritor.

  • FileGet lê cadeias de comprimento variável que não são elementos de estruturas sem esperar o descritor de comprimento de dois bytes. O número de bytes lidos é igual ao número de caracteres já presentes na cadeia.

    Importante

    Ler a partir de um ficheiro usando a FileGet função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Ver também

Aplica-se a