FileSystem.FilePut Metod

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, long Value, long RecordNumber = -1);

static member FilePut : int * int64 * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Long, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, string Value, long RecordNumber = -1, bool StringIsFixedLength = false);

static member FilePut : int * string * int64 * bool -> unit

Public Sub FilePut (FileNumber As Integer, Value As String, Optional RecordNumber As Long = -1, Optional StringIsFixedLength As Boolean = false)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public:
 static void FilePut(System::Object ^ FileNumber, System::Object ^ Value, System::Object ^ RecordNumber);

[System.Obsolete("FileSystem.FilePut has been deprecated. Use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types.")]
public static void FilePut(object FileNumber, object Value, object RecordNumber);

[System.Obsolete("This member has been deprecated. Please use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types. http://go.microsoft.com/fwlink/?linkid=14202")]
public static void FilePut(object FileNumber, object Value, object RecordNumber);

[System.Obsolete("Use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types")]
public static void FilePut(object FileNumber, object Value, object RecordNumber = -1);

[System.Obsolete("This member has been deprecated. Please use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types. http://go.microsoft.com/fwlink/?linkid=14202")]
public static void FilePut(object FileNumber, object Value, object RecordNumber = -1);

[<System.Obsolete("FileSystem.FilePut has been deprecated. Use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types.")>]
static member FilePut : obj * obj * obj -> unit

[<System.Obsolete("This member has been deprecated. Please use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types. http://go.microsoft.com/fwlink/?linkid=14202")>]
static member FilePut : obj * obj * obj -> unit

[<System.Obsolete("Use FilePutObject to write Object types, or coerce FileNumber and RecordNumber to Integer for writing non-Object types")>]
static member FilePut : obj * obj * obj -> unit

Public Sub FilePut (FileNumber As Object, Value As Object, RecordNumber As Object)

Public Sub FilePut (FileNumber As Object, Value As Object, Optional RecordNumber As Object = -1)

Parametrar

Attribut

ObsoleteAttribute

Undantag

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The origin object type could not be statically analyzed and may be trimmed")]
public static void FilePut(int FileNumber, ValueType Value, long RecordNumber = -1);

public static void FilePut(int FileNumber, ValueType Value, long RecordNumber = -1);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The origin object type could not be statically analyzed and may be trimmed")>]
static member FilePut : int * ValueType * int64 -> unit

static member FilePut : int * ValueType * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As ValueType, Optional RecordNumber As Long = -1)

Parametrar

Attribut

RequiresUnreferencedCodeAttribute

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength iFileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, float Value, long RecordNumber = -1);

static member FilePut : int * single * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Single, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, int Value, long RecordNumber = -1);

static member FilePut : int * int * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Integer, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The origin object type could not be statically analyzed and may be trimmed")]
public static void FilePut(int FileNumber, Array Value, long RecordNumber = -1, bool ArrayIsDynamic = false, bool StringIsFixedLength = false);

public static void FilePut(int FileNumber, Array Value, long RecordNumber = -1, bool ArrayIsDynamic = false, bool StringIsFixedLength = false);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The origin object type could not be statically analyzed and may be trimmed")>]
static member FilePut : int * Array * int64 * bool * bool -> unit

static member FilePut : int * Array * int64 * bool * bool -> unit

Public Sub FilePut (FileNumber As Integer, Value As Array, Optional RecordNumber As Long = -1, Optional ArrayIsDynamic As Boolean = false, Optional StringIsFixedLength As Boolean = false)

Parametrar

Attribut

RequiresUnreferencedCodeAttribute

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, double Value, long RecordNumber = -1);

static member FilePut : int * double * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Double, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, decimal Value, long RecordNumber = -1);

static member FilePut : int * decimal * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Decimal, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, DateTime Value, long RecordNumber = -1);

static member FilePut : int * DateTime * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As DateTime, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, char Value, long RecordNumber = -1);

static member FilePut : int * char * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Char, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, byte Value, long RecordNumber = -1);

static member FilePut : int * byte * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Byte, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, bool Value, long RecordNumber = -1);

static member FilePut : int * bool * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Boolean, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierar VarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

Källa:

FileSystem.vb

public static void FilePut(int FileNumber, short Value, long RecordNumber = -1);

static member FilePut : int * int16 * int64 -> unit

Public Sub FilePut (FileNumber As Integer, Value As Short, Optional RecordNumber As Long = -1)

Parametrar

Undantag

Exempel

I det FilePut här exemplet används funktionen för att skriva data till en fil. Fem poster i strukturen Person skrivs till filen.

Structure Person
    Public ID As Integer
    Public Name As String
End Structure

Sub WriteData()
    Dim PatientRecord As Person
    Dim recordNumber As Integer
    '    Open file for random access.
    FileOpen(1, "C:\TESTFILE.txt", OpenMode.Binary)
    ' Loop 5 times.
    For recordNumber = 1 To 5
        ' Define ID.
        PatientRecord.ID = recordNumber
        ' Create a string.
        PatientRecord.Name = "Name " & recordNumber
        ' Write record to file.
        FilePut(1, PatientRecord)
    Next recordNumber
    FileClose(1)
End Sub

Kommentarer

FilePut är endast giltigt i Random och Binary läge.

Data som skrivs med FilePut läse vanligtvis från en fil med hjälp FileGetav .

Den första posten eller byte i en fil är på plats 1, den andra posten eller byte är på plats 2 och så vidare. Om du utelämnar RecordNumberskrivs nästa post eller byte efter den sista FileGet eller FilePut funktionen eller som pekas på av den sista Seek funktionen.

Argumentet StringIsFixedLength styr om funktionen tolkar strängar som variabel eller fast längd. FilePut skriver inte längdbeskrivningen när argumentet är True. Om du använder StringIsFixedLength = True med FilePutmåste du göra samma sak med FileGet, och du måste se till att strängen initieras till den förväntade längden.

Slumpmässigt läge

För filer som öppnas i Random läge gäller följande regler:

• Om längden på de data som skrivs är mindre än den längd som anges i -satsen RecordLength i FileOpen funktionen skriver FilePut du efterföljande poster på postlängdsgränser. Utrymmet mellan slutet av en post och början av nästa post är vadderat med det befintliga innehållet i filbufferten. Eftersom mängden utfyllnadsdata inte kan fastställas med säkerhet är det i allmänhet en bra idé att se till att postlängden matchar längden på de data som skrivs. Om längden på de data som skrivs är större än den längd som anges i -satsen i RecordLengthFileOpen funktionen genereras ett undantag.

• Om variabeln som skrivs är en sträng FilePut skriver du en tvåbytesbeskrivning som innehåller stränglängden och skriver sedan de data som går in i variabeln. Därför måste postlängden RecordLength som anges av -satsen i FileOpen funktionen vara minst två byte större än strängens faktiska längd.

• Om variabeln som skrivs är ett objekt som innehåller en numerisk typ skriver FilePut du två byte som identifierar VarType objektet och skriver sedan variabeln. När du till exempel skriver ett objekt som innehåller ett heltal FilePut skriver du sex byte: två byte som identifierar objektet som VarType(3) (Integer) och fyra byte som innehåller data. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst två byte större än det faktiska antalet byte som krävs för att lagra variabeln.

• Om variabeln som skrivs är ett objekt som innehåller en sträng skriver FilePut du en tvåbytesbeskrivning som identifierarVarType(8) objektet, en tvåbytesbeskrivning som anger längden på strängen och skriver sedan strängdata. Postlängden som anges av parametern RecordLengthFileOpen i funktionen måste vara minst fyra byte större än strängens faktiska längd. Om du vill placera en sträng utan beskrivningen bör du skicka True till parametern StringIsFixedLength och strängen som du läser in i ska vara rätt längd.

• Om variabeln som skrivs är en matris kan du välja om du vill skriva en beskrivning för matrisens storlek och dimensioner. Visual Basic 6.0 och tidigare versioner skriver filbeskrivningen för en dynamisk matris men inte för en matris med fast storlek. Visual Basic 2005 skrivs inte beskrivningen som standard. Om du vill skriva beskrivningen anger du parametern ArrayIsDynamic till True. När du skriver matrisen måste du matcha hur matrisen ska läsas. Om den ska läsas med beskrivningen måste du skriva beskrivningen. Beskrivningen anger matrisens rangordning, storlek och de lägre gränserna för varje rangordning. Dess längd är lika med 2 plus 8 gånger antalet dimensioner: (2 + 8 * NumberOfDimensions). Postlängden RecordLength som anges av -satsen i FileOpen funktionen måste vara större än eller lika med summan av alla byte som krävs för att skriva matrisdata och matrisbeskrivningen. Följande matrisdeklaration kräver till exempel 218 byte när matrisen skrivs till disk.

  Dim MyArray(4, 9) As Integer
  

• Om variabeln som skrivs är någon annan typ av variabel (inte en variabellängdssträng eller ett objekt) FilePut skriver endast variabeldata. Den postlängd som anges av RecordLength -satsen i FileOpen funktionen måste vara större än eller lika med längden på de data som skrivs.

• FilePut skriver element i strukturer som om var och en skrevs individuellt, förutom att det inte finns någon utfyllnad mellan element. Attributet VBFixedString kan tillämpas på strängfält i strukturerna för att ange storleken på strängen när den skrivs till disk.

  Note

  Strängfält som har fler byte än vad som anges av attributet trunkeras när de VBFixedString skrivs till disken.

Binärt läge

För filer som öppnas i Binary läge gäller de flesta Random lägesreglerna, med vissa undantag. Följande regler för filer som öppnas i Binary läge skiljer sig från reglerna för Random läge:

• RecordLength Satsen i FileOpen funktionen har ingen effekt. FilePut skriver alla variabler till disken sammanhängande, dvs. utan utfyllnad mellan poster.

• För alla andra matriser än en matris i en struktur skriver FilePut endast data. Ingen beskrivning skrivs.

• FilePut skriver strängar med variabel längd som inte är element i strukturer utan två bytes längdbeskrivning. Antalet byte som skrivs är lika med antalet tecken i strängen. Följande instruktioner skriver till exempel 11 byte till filnummer 1:

  Dim hellow As String = "Hello World"
  FilePut(1, hellow)
  

• Att skriva till en fil med hjälp FilePut av funktionen kräver Write åtkomst från FileIOPermissionAccess uppräkningen.

Se även

• FileGet
• FileOpen(Int32, String, OpenMode, OpenAccess, OpenShare, Int32)
• Seek
• FileGetObject(Int32, Object, Int64)
• VBFixedStringAttribute
• Len(UInt16)
• ArgumentException
• IOException
• Skriva till filer i Visual Basic