FileSystem.Seek Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Devolve uma Long especificação da posição atual de leitura/escrita num ficheiro aberto usando a FileOpen função, ou define a posição para a próxima operação de leitura/escrita num ficheiro aberto usando a FileOpen função. A My funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que Seek. Para obter mais informações, veja FileSystem.

Sobrecargas

Name Description

Name	Description
Seek(Int32)	Devolve uma `Long` especificação da posição atual de leitura/escrita num ficheiro aberto usando a `FileOpen` função, ou define a posição para a próxima operação de leitura/escrita num ficheiro aberto usando a `FileOpen` função. A `My` funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que `Seek`. Para obter mais informações, veja FileSystem.
Seek(Int32, Int64)	Devolve uma `Long` especificação da posição atual de leitura/escrita num ficheiro aberto usando a `FileOpen` função, ou define a posição para a próxima operação de leitura/escrita num ficheiro aberto usando a `FileOpen` função. A `My` funcionalidade dá-lhe melhor produtividade e desempenho nas operações de I/O de ficheiros do que `Seek`. Para obter mais informações, veja FileSystem.

Seek(Int32)

Seek(Int32, Int64)

Seek(Int32)

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

Required. E Integer que contém um número de ficheiro válido.

Devoluções

Int64

A especificar a posição atual de leitura/escrita num ficheiro Long aberto usando a FileOpen função, ou define a posição para a próxima operação de leitura/escrita num ficheiro aberto usando a FileOpen função.

Exceções

IOException

O modo ficheiro é inválido.

Exemplos

Este exemplo usa a Seek função para devolver a posição atual do ficheiro. O exemplo assume TestFile que é um ficheiro que contém registos da estrutura Record.

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

Para ficheiros abertos no Random modo, Seek devolve o número do registo seguinte.

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 ficheiros abertos em modos diferentes do Random modo, Seek devolve a posição do byte em que ocorre a próxima operação. Assuma TestFile que é um ficheiro que contém 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 utiliza a Seek função para definir a posição para a próxima leitura ou escrita num ficheiro.

Para ficheiros abertos em modos diferentes do Random modo, Seek define a posição do byte onde ocorre a próxima operação. Assuma TestFile que é um ficheiro que contém 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)

Observações

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

O seguinte descreve os valores de retorno para cada modo de acesso a ficheiros:

Mode	Valor de retorno
`Random`	Número do registo seguinte lido ou escrito
`Binary`, `Input`, `Output`, `Append`	Posição do byte onde ocorre a próxima operação. O primeiro byte num ficheiro está na posição 1, o segundo byte está na posição 2 e assim sucessivamente.

Ver também

Aplica-se a