FileSystem.Seek Método

Definição

Retorna um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Seek. Para obter mais informações, consulte FileSystem.

Sobrecargas

Seek(Int32)

Retorna um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Seek. Para obter mais informações, consulte FileSystem.

Seek(Int32, Int64)

Retorna um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Seek. Para obter mais informações, consulte FileSystem.

Seek(Int32)

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Seek. Para obter mais informações, consulte FileSystem.

public:
 static long Seek(int FileNumber);
public static long Seek (int FileNumber);
static member Seek : int -> int64
Public Function Seek (FileNumber As Integer) As Long

Parâmetros

FileNumber
Int32

Obrigatórios. Um Integer que contém um número de arquivo válido.

Retornos

Um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen.

Exceções

O modo de arquivo é inválido.

Exemplos

Este exemplo usa a Seek função para retornar a posição do arquivo atual. O exemplo pressupõe TestFile que seja um arquivo que contém registros da estrutura Record.

Structure Record   ' Define user-defined type.
    Dim ID As Integer
    Dim Name As String
End Structure

Para arquivos abertos no Random modo , Seek retorna o número do próximo registro.

FileOpen(1, "TESTFILE", OpenMode.Random)
Do While Not EOF(1)
    WriteLine(1, Seek(1))   ' Write record number.
    FileGet(1, MyRecord, -1)   ' Read next record.
Loop
FileClose(1)

Para arquivos abertos em modos diferentes do Random modo , Seek retorna a posição de byte na qual a próxima operação ocorre. Suponha que TestFile seja um arquivo contendo várias linhas de texto.

' Report character position at beginning of each line.
Dim TextLine As String
FileOpen(1, "TESTFILE", OpenMode.Input)   ' Open file for reading.
While Not EOF(1)
    ' Read next line.
    TextLine = LineInput(1)
    ' Position of next line.
    MsgBox(Seek(1))
End While
FileClose(1)

Este exemplo usa a Seek função para definir a posição para a próxima leitura ou gravação em um arquivo.

Para arquivos abertos em modos diferentes do Random modo , Seek define a posição de byte na qual a próxima operação ocorre. Suponha que TestFile seja um arquivo contendo várias linhas de texto.

Dim someText As String = "This is a test string."
' Open file for output.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Move to the third character.
Seek(1, 3)
Input(1, someText)
Console.WriteLine(someText)
FileClose(1)

Comentários

Seek retorna um valor entre 1 e 2.147.483.647 (equivalente a 2^31 - 1), inclusive.

O seguinte descreve os valores retornados para cada modo de acesso a arquivos:

Modo Valor de retorno
Random Número do próximo registro lido ou gravado
Binary, Input, Output, Append Posição de byte na qual a próxima operação ocorre. O primeiro byte em um arquivo está na posição 1, o segundo byte está na posição 2 e assim por diante.

Confira também

Aplica-se a

Seek(Int32, Int64)

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna um Long que especifica a posição de leitura/gravação atual em um arquivo aberto usando a função FileOpen ou define a posição para a próxima operação de leitura/gravação em um arquivo aberto usando a função FileOpen. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que Seek. Para obter mais informações, consulte FileSystem.

public:
 static void Seek(int FileNumber, long Position);
public static void Seek (int FileNumber, long Position);
static member Seek : int * int64 -> unit
Public Sub Seek (FileNumber As Integer, Position As Long)

Parâmetros

FileNumber
Int32

Obrigatórios. Um Integer que contém um número de arquivo válido.

Position
Int64

Obrigatórios. Número no intervalo de 1 a 2.147.483.647 (incluindo este número), que indica o local em que a próxima operação de leitura/gravação deverá ocorrer.

Exceções

O modo de arquivo é inválido.

Exemplos

Este exemplo usa a Seek função para retornar a posição do arquivo atual. O exemplo pressupõe TestFile que seja um arquivo que contém registros da estrutura Record.

Structure Record   ' Define user-defined type.
    Dim ID As Integer
    Dim Name As String
End Structure

Para arquivos abertos no Random modo , Seek retorna o número do próximo registro.

FileOpen(1, "TESTFILE", OpenMode.Random)
Do While Not EOF(1)
    WriteLine(1, Seek(1))   ' Write record number.
    FileGet(1, MyRecord, -1)   ' Read next record.
Loop
FileClose(1)

Para arquivos abertos em modos diferentes do Random modo , Seek retorna a posição de byte na qual a próxima operação ocorre. Suponha que TestFile seja um arquivo contendo várias linhas de texto.

' Report character position at beginning of each line.
Dim TextLine As String
FileOpen(1, "TESTFILE", OpenMode.Input)   ' Open file for reading.
While Not EOF(1)
    ' Read next line.
    TextLine = LineInput(1)
    ' Position of next line.
    MsgBox(Seek(1))
End While
FileClose(1)

Este exemplo usa a Seek função para definir a posição para a próxima leitura ou gravação em um arquivo.

Para arquivos abertos em modos diferentes do Random modo , Seek define a posição de byte na qual a próxima operação ocorre. Suponha que TestFile seja um arquivo contendo várias linhas de texto.

Dim someText As String = "This is a test string."
' Open file for output.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Move to the third character.
Seek(1, 3)
Input(1, someText)
Console.WriteLine(someText)
FileClose(1)

Comentários

Seek retorna um valor entre 1 e 2.147.483.647 (equivalente a 2^31 - 1), inclusive.

O seguinte descreve os valores retornados para cada modo de acesso a arquivos:

Modo Valor de retorno
Random Número do próximo registro lido ou gravado
Binary, Input, Output, Append Posição de byte na qual a próxima operação ocorre. O primeiro byte em um arquivo está na posição 1, o segundo byte está na posição 2 e assim por diante.

Confira também

Aplica-se a