FileSystem.FileGet Metoda

Definice

Obor názvů:

Microsoft.VisualBasic

Sestavení:

Microsoft.VisualBasic.Core.dll

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu FileSystem.

Přetížení

FileGet(Int32, Array, Int64, Boolean, Boolean)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, String, Int64, Boolean)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, ValueType, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Single, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Int64, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Int32, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Decimal, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Double, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, DateTime, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Char, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Byte, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Boolean, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.
FileGet(Int32, Int16, Int64)	Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu FileSystem.

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

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Array

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

ArrayIsDynamic

Boolean

Nepovinný parametr. Použije se pouze při psaní pole. Určuje, zda má být pole považováno za dynamické a zda je nutný popisovač pole popisující velikost a meze pole.

StringIsFixedLength

Boolean

Nepovinný parametr. Platí pouze při zápisu řetězce. Určuje, zda se má zapsat dvoubajtů popisovač pro řetězec, který popisuje délku. Výchozí formát je False.

Výjimky

ArgumentException

RecordNumber < 1 a ne rovno -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna stávajícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice pole předané do FileGet určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu určená parametrem RecordLength ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro popisovač: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec s proměnnou délkou nebo objekt), FileGet přečte pouze data proměnné. Délka záznamu určená klauzulí RecordLength ve FileOpen funkci musí být větší než nebo rovna délce načítaných dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi prvky neexistuje žádné odsazení. Na disku má předponu dynamická matice v uživatelem definovaném typu (zapsaná pomocí FilePut) popisovač, jehož délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na řetězcová pole ve strukturách a indikovat velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLengthFileOpen ve funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakoukoli jinou matici než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnnou délkou, které nejsou prvky struktur, aniž by očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, String, Int64, Boolean)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

String

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

StringIsFixedLength

Boolean

Nepovinný parametr. Platí pouze při zápisu řetězce. Určuje, zda se má zapsat dvoubajtů popisovač pro řetězec, který popisuje délku. Výchozí formát je False.

Výjimky

ArgumentException

RecordNumber < 1 a ne rovno -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice pole předané do FileGet určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu určená parametrem RecordLength ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro popisovač: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec s proměnnou délkou nebo objekt), FileGet přečte pouze data proměnné. Délka záznamu určená klauzulí RecordLength ve FileOpen funkci musí být větší než nebo rovna délce načítaných dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi prvky neexistuje žádné odsazení. Na disku má předponu dynamická matice v uživatelem definovaném typu (zapsaná pomocí FilePut) popisovač, jehož délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na řetězcová pole ve strukturách a indikovat velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLengthFileOpen ve funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakoukoli jinou matici než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnnou délkou, které nejsou prvky struktur, aniž by očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, ValueType, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

ValueType

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a ne rovno -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice pole předané do FileGet určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu určená parametrem RecordLength ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro popisovač: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec s proměnnou délkou nebo objekt), FileGet přečte pouze data proměnné. Délka záznamu určená klauzulí RecordLength ve FileOpen funkci musí být větší než nebo rovna délce načítaných dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi prvky neexistuje žádné odsazení. Na disku má předponu dynamická matice v uživatelem definovaném typu (zapsaná pomocí FilePut) popisovač, jehož délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na řetězcová pole ve strukturách a indikovat velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLengthFileOpen ve funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakoukoli jinou matici než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnnou délkou, které nejsou prvky struktur, aniž by očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Single, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Single

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a ne rovno -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Int64, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Int64

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data načtená pomocí FileGet příkazu se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Int32, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích souborů než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Int32

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice pole předané do FileGet určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu určená parametrem RecordLength ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro popisovač: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec s proměnnou délkou nebo objekt), FileGet přečte pouze data proměnné. Délka záznamu určená klauzulí RecordLength ve FileOpen funkci musí být větší než nebo rovna délce načítaných dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi prvky neexistuje žádné odsazení. Na disku má předponu dynamická matice v uživatelem definovaném typu (zapsaná pomocí FilePut) popisovač, jehož délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na řetězcová pole ve strukturách a indikovat velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLengthFileOpen ve funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakoukoli jinou matici než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnnou délkou, které nejsou prvky struktur, aniž by očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Decimal, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Decimal

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a ne rovno -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data přečtená pomocí FileGet se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGetFilePut funkcí (nebo odkazováním poslední Seek funkce).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy o hranicích záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte, ve výchozím nastavení řetězec, FileGet načte dvoubajtů popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné přejdou. Proto délka záznamu určená klauzulí RecordLengthFileOpen funkce musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete číst řetězec bez popisovače, měli byste parametru StringIsFixedLength předat True a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice pole předané do FileGet určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu určená parametrem RecordLength ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro popisovač: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec s proměnnou délkou nebo objekt), FileGet přečte pouze data proměnné. Délka záznamu určená klauzulí RecordLength ve FileOpen funkci musí být větší než nebo rovna délce načítaných dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi prvky neexistuje žádné odsazení. Na disku má předponu dynamická matice v uživatelem definovaném typu (zapsaná pomocí FilePut) popisovač, jehož délka se rovná 2 plus 8násobek počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na řetězcová pole ve strukturách a indikovat velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLengthFileOpen ve funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakoukoli jinou matici než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Double, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Double

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data načtená pomocí FileGet příkazu se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocíFileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, DateTime, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

DateTime

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data čtená pomocí FileGet příkazu se obvykle zapisuje do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce,FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Char, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Char

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data čtená pomocí FileGet příkazu se obvykle zapisuje do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Byte, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Byte

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data čtená pomocí FileGet příkazu se obvykle zapisuje do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud se popisovač nepoužívá. Pak velikost a hranice předaného FileGet pole určí, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Boolean, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Boolean

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data čtená pomocí FileGet příkazu se obvykle zapisuje do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocíFileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic

FileGet(Int32, Int16, Int64)

Zdroj:

FileSystem.vb

Čte data z otevřeného souboru na disku do proměnné. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než FileGet. Další informace naleznete v tématu 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)

Parametry

FileNumber

Int32

Povinná hodnota. Libovolné platné číslo souboru

Value

Int16

Povinná hodnota. Platný název proměnné, do které jsou načtena data.

RecordNumber

Int64

Nepovinný parametr. Číslo záznamu (Random soubory režimu) nebo číslo bajtu (Binary soubory režimu), od kterého začíná čtení.

Výjimky

ArgumentException

RecordNumber < 1 a nerovná se -1.

IOException

Režim souboru je neplatný.

Poznámky

FileGet je platný pouze v Random režimu a Binary .

Data načtená pomocí FileGet příkazu se obvykle zapisují do souboru pomocí FilePutpříkazu .

První záznam nebo bajt v souboru se nachází na pozici 1, druhý záznam nebo bajt na pozici 2 atd. Pokud vynecháte RecordNumber, přečte se další záznam nebo bajt za poslední FileGet funkcí nebo FilePut (nebo odkazem na poslední Seek funkci).

Důležité

Během čtení ze souborů se při rozhodování o obsahu souboru neřiďte příponou názvu souboru. Například soubor s názvem Form1.vb nemusí být zdrojový soubor Visual Basic.

Náhodný režim

Pro soubory otevřené v Random režimu platí následující pravidla:

• Pokud je délka čtených dat menší než délka zadaná v RecordLength klauzuli FileOpen funkce, FileGet přečte následující záznamy na hranicích délky záznamů. Mezera mezi koncem jednoho záznamu a začátkem dalšího záznamu je vyplněna existujícím obsahem vyrovnávací paměti souboru. Protože množství dat odsazení nelze s jistotou určit, je obecně vhodné, aby délka záznamu odpovídala délce čtených dat.

• Pokud je proměnnou, do které se čte řetězec, FileGet ve výchozím nastavení načte dvou bajtový popisovač, který obsahuje délku řetězce, a pak načte data, která do proměnné putují. Délka záznamu určená klauzulí RecordLengthFileOpen funkce proto musí být alespoň o dva bajty větší než skutečná délka řetězce. Visual Basic verze 6.0 a starší podporuje řetězce s pevnou délkou; při vložení do souboru popisovač délky není zapsán. Pokud chcete přečíst řetězec bez popisovače, měli byste předat True parametru StringIsFixedLength a řetězec, do kterého jste načetli, by měl mít správnou délku.

• Pokud je proměnná načítána do pole, můžete zvolit, zda se má načíst popisovač pro velikost a rozměry pole. Pokud chcete napsat popisovač, nastavte ArrayIsDynamic parametr na True. Při čtení pole je třeba dodržet způsob, jakým bylo pole zapsáno. Pokud byl zápis proveden s popisovačem, je nutné popisovač načíst. Pokud popisovač není použit, velikost a hranice předaného FileGet pole určuje, co se má číst.

  Popisovač určuje pořadí pole, velikost a dolní meze každého pořadí. Jeho délka se rovná 2 plus 8 násobku počtu rozměrů: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená parametrem ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných k zápisu dat pole a popisovače pole. Například následující deklarace pole vyžaduje při zápisu pole na disk 218 bajtů.

  Dim MyArray(4, 9) As Integer
  

  218 bajtů se rozdělí takto:

  • 18 bajtů pro deskriptor: (2 + 8 × 2)

  • 200 bajtů pro data: (5 × 10 × 4).

• Pokud proměnná, do které se čte, představuje jiný typ proměnné (ne řetězec délky proměnné ani objekt), FileGet přečte pouze data proměnné. Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší než nebo rovna délce čtených dat.

• FileGet čte prvky struktur, jako by byly čteny jednotlivě, s tím rozdílem, že mezi elementy není žádné odsazení. Před dynamickou matici v uživatelsky definovaném typu (zapsaném pomocí FilePut) na disku je předpona popisovače, jehož délka se rovná 2 plus 8násobku počtu dimenzí: (2 + 8 * NumberOfDimensions). Délka záznamu RecordLength určená klauzulí ve FileOpen funkci musí být větší nebo rovna součtu všech bajtů potřebných ke čtení jednotlivých prvků. To zahrnuje všechna pole a jejich popisovače. Atribut VBFixedString lze použít na pole řetězců ve strukturách a označit tak velikost řetězce při zápisu na disk.

Binární režim

U souborů otevřených v Binary režimu se s některými výjimkami použije většina Random pravidel režimu. Následující pravidla pro soubory otevřené v Binary režimu se liší od pravidel pro Random režim:

• Klauzule RecordLength ve FileOpen funkci nemá žádný účinek. FileGet čte všechny proměnné z disku souvisle; to znamená bez odsazení mezi záznamy.

• Pro jakékoli pole jiné než pole ve struktuře čte FileGet pouze data. Není čten žádný popisovač.

• FileGet čte řetězce s proměnlivou délkou, které nejsou prvky struktur, aniž by se očekával popisovač délky dvou bajtů. Počet přečtených bajtů se rovná počtu znaků, které se již v řetězci nacházejí.

  Důležité

  Čtení ze souboru pomocí FileGet funkce vyžaduje Read přístup z výčtu FileIOPermissionAccess .

Viz také

• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• FilePut
• Seek
• FileGetObject(Int32, Object, Int64)
• Čtení ze souborů v jazyce Visual Basic
• Zápis do souborů v jazyce Visual Basic