Marshal.ReadByte Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte jeden bajt z nespravované paměti. Podporuje se čtení z nezarovnaných umístění v paměti.
Přetížení
ReadByte(IntPtr, Int32) |
Načte jeden bajt při daném posunu (nebo indexu) z nespravované paměti. |
ReadByte(Object, Int32) |
Zastaralé.
Načte jeden bajt při daném posunu (nebo indexu) z nespravované paměti. |
ReadByte(IntPtr) |
Načte jeden bajt z nespravované paměti. |
ReadByte(IntPtr, Int32)
- Zdroj:
- Marshal.cs
- Zdroj:
- Marshal.cs
- Zdroj:
- Marshal.cs
Načte jeden bajt při daném posunu (nebo indexu) z nespravované paměti.
public:
static System::Byte ReadByte(IntPtr ptr, int ofs);
[System.Security.SecurityCritical]
public static byte ReadByte (IntPtr ptr, int ofs);
public static byte ReadByte (IntPtr ptr, int ofs);
[<System.Security.SecurityCritical>]
static member ReadByte : nativeint * int -> byte
static member ReadByte : nativeint * int -> byte
Public Shared Function ReadByte (ptr As IntPtr, ofs As Integer) As Byte
Parametry
- ptr
-
IntPtr
nativeint
Základní adresa v nespravované paměti, ze které se má číst.
- ofs
- Int32
Další posun bajtů, který se přidá do parametru ptr
před čtením.
Návraty
Bajt přečtený z nespravované paměti při daném posunu.
- Atributy
Výjimky
Základní adresa (ptr
) a posunutého bajtu (ofs
) vytváří adresu s hodnotou null nebo neplatnou.
Příklady
Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadByte metod a WriteByte .
static void ReadWriteByte()
{
// Allocate unmanaged memory.
int elementSize = 1;
IntPtr unmanagedArray = Marshal.AllocHGlobal(10 * elementSize);
// Set the 10 elements of the C-style unmanagedArray
for (int i = 0; i < 10; i++)
{
Marshal.WriteByte(unmanagedArray, i * elementSize, ((Byte)(i + 1)));
}
Console.WriteLine("Unmanaged memory written.");
Console.WriteLine("Reading unmanaged memory:");
// Print the 10 elements of the C-style unmanagedArray
for (int i = 0; i < 10; i++)
{
Console.WriteLine(Marshal.ReadByte(unmanagedArray, i * elementSize));
}
Marshal.FreeHGlobal(unmanagedArray);
Console.WriteLine("Done. Press Enter to continue.");
Console.ReadLine();
}
Sub ReadWriteByte()
' Allocate unmanaged memory.
Dim elementSize As Integer = 1
Dim unmanagedArray As IntPtr = Marshal.AllocHGlobal(10 * elementSize)
' Set the 10 elements of the C-style unmanagedArray
For i As Integer = 0 To 9
Marshal.WriteByte(unmanagedArray, i * elementSize, CType(i + 1, Byte))
Next i
Console.WriteLine("Unmanaged memory written.")
Console.WriteLine("Reading unmanaged memory:")
' Print the 10 elements of the C-style unmanagedArray
For i As Integer = 0 To 9
Console.WriteLine(Marshal.ReadByte(unmanagedArray, i * elementSize))
Next i
Marshal.FreeHGlobal(unmanagedArray)
Console.WriteLine("Done. Press Enter to continue.")
Console.ReadLine()
End Sub
Následující příklad ukazuje, jak použít metodu ReadByte ke čtení hodnoty nespravovaného znaku.
using namespace System;
using namespace System::Runtime::InteropServices;
void main()
{
// Create an unmanaged byte.
const char * myString = "bB";
// Read the second character of the c string as a managed byte.
Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString, 1);
// Display the byte to the console.
Console::WriteLine(myManagedByte);
}
Poznámky
ReadByte umožňuje přímou interakci s nespravovaným polem bajtů ve stylu jazyka C, čímž eliminuje náklady spojené s kopírováním celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.
Podporuje se čtení z nezarovnaných umístění v paměti.
Viz také
Platí pro
ReadByte(Object, Int32)
- Zdroj:
- Marshal.CoreCLR.cs
- Zdroj:
- Marshal.CoreCLR.cs
- Zdroj:
- Marshal.CoreCLR.cs
Upozornění
ReadByte(Object, Int32) may be unavailable in future releases.
Načte jeden bajt při daném posunu (nebo indexu) z nespravované paměti.
public:
static System::Byte ReadByte(System::Object ^ ptr, int ofs);
[System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static byte ReadByte (object ptr, int ofs);
[System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")]
public static byte ReadByte (object ptr, int ofs);
public static byte ReadByte (object ptr, int ofs);
[System.Security.SecurityCritical]
public static byte ReadByte (object ptr, int ofs);
[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
[<System.Security.SecurityCritical>]
static member ReadByte : obj * int -> byte
[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
static member ReadByte : obj * int -> byte
static member ReadByte : obj * int -> byte
[<System.Security.SecurityCritical>]
static member ReadByte : obj * int -> byte
Public Shared Function ReadByte (ptr As Object, ofs As Integer) As Byte
Parametry
- ptr
- Object
Základní adresa zdrojového objektu v nespravované paměti.
- ofs
- Int32
Další posun bajtů, který se přidá do parametru ptr
před čtením.
Návraty
Bajt přečtený z nespravované paměti při daném posunu.
- Atributy
Výjimky
Základní adresa (ptr
) a posunutého bajtu (ofs
) vytváří adresu s hodnotou null nebo neplatnou.
ptr
ArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.
Poznámky
ReadByte umožňuje přímou interakci s nespravovaným polem bajtů ve stylu jazyka C, čímž eliminuje náklady spojené s kopírováním celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.
Podporuje se čtení z nezarovnaných umístění v paměti.
Viz také
Platí pro
ReadByte(IntPtr)
- Zdroj:
- Marshal.cs
- Zdroj:
- Marshal.cs
- Zdroj:
- Marshal.cs
Načte jeden bajt z nespravované paměti.
public:
static System::Byte ReadByte(IntPtr ptr);
[System.Security.SecurityCritical]
public static byte ReadByte (IntPtr ptr);
public static byte ReadByte (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member ReadByte : nativeint -> byte
static member ReadByte : nativeint -> byte
Public Shared Function ReadByte (ptr As IntPtr) As Byte
Parametry
- ptr
-
IntPtr
nativeint
Adresa v nespravované paměti, ze které se má číst.
Návraty
Bajt přečtený z nespravované paměti.
- Atributy
Výjimky
ptr
není rozpoznaný formát.
-nebo-
ptr
je null
.
-nebo-
Formát ptr
je neplatný.
Příklady
Následující příklad vytvoří blok nespravované paměti, zapíše bajt do nespravované paměti, načte bajt zpět z nespravované paměti a poté odstraní nespravovanou paměť.
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main(string[] args)
{
// Allocate 1 byte of unmanaged memory.
IntPtr hGlobal = Marshal.AllocHGlobal(1);
// Create a new byte.
byte b = 1;
Console.WriteLine("Byte written to unmanaged memory: " + b);
// Write the byte to unmanaged memory.
Marshal.WriteByte(hGlobal, b);
// Read byte from unmanaged memory.
byte c = Marshal.ReadByte(hGlobal);
Console.WriteLine("Byte read from unmanaged memory: " + c);
// Free the unmanaged memory.
Marshal.FreeHGlobal(hGlobal);
Console.WriteLine("Unmanaged memory was disposed.");
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Allocate 1 byte of unmanaged memory.
Dim hGlobal As IntPtr = Marshal.AllocHGlobal(1)
' Create a new byte.
Dim b As Byte = 1
Console.WriteLine("Byte written to unmanaged memory: {0}", b)
' Write the byte to unmanaged memory.
Marshal.WriteByte(hGlobal, b)
' Read byte from unmanaged memory.
Dim c As Byte = Marshal.ReadByte(hGlobal)
Console.WriteLine("Byte read from unmanaged memory: {0}", c)
' Free the unmanaged memory.
Marshal.FreeHGlobal(hGlobal)
Console.WriteLine("Unmanaged memory was disposed.")
End Sub
End Module
Následující příklad ukazuje, jak použít metodu ReadByte ke čtení hodnoty nespravovaného znaku.
using namespace System;
using namespace System::Runtime::InteropServices;
void main()
{
// Create an unmanaged byte.
const char * myString = "b";
// Read the c string as a managed byte.
Byte ^ myManagedByte = Marshal::ReadByte((IntPtr) (char *) myString);
// Display the byte to the console.
Console::WriteLine(myManagedByte);
}
Poznámky
ReadByte má implicitní posun 0. Tato metoda umožňuje přímou interakci s nespravovaným polem bajtů ve stylu jazyka C a eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před čtením hodnot jeho prvků.
Podporuje se čtení z nezarovnaných umístění v paměti.
Viz také
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro