Marshal.ReadByte Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Načte jeden bajt z nespravované paměti. Čtení z nerovnaných umístění paměti se podporuje.

Přetížení

Name	Description
ReadByte(IntPtr, Int32)	Načte jeden bajt na daném posunu (nebo indexu) z nespravované paměti.
ReadByte(Object, Int32)	Zastaralé. Načte jeden bajt na 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

Načte jeden bajt na daném posunu (nebo indexu) z nespravované paměti.

public:
 static System::Byte ReadByte(IntPtr ptr, int ofs);

public static byte ReadByte(IntPtr ptr, int ofs);

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 bajtu, který se před čtením přidá do parametru ptr .

Návraty

Byte

Bajt přečtený z nespravované paměti na daném posunu.

Výjimky

AccessViolationException

Základní adresa (ptr) plus posun bajtů (ofs) vytvoří hodnotu null nebo neplatnou adresu.

Příklady

Následující příklad ukazuje, jak číst a zapisovat do nespravovaného pole pomocí ReadByte a WriteByte metod.

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 bajtovým polem 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 prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)

ReadByte(Object, Int32)

Zdroj:

Marshal.CoreCLR.cs

Upozornění

ReadByte(Object, Int32) may be unavailable in future releases.

Načte jeden bajt na 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.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
public static byte ReadByte(object ptr, int ofs);

[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
static member ReadByte : obj * int -> byte

Public Shared Function ReadByte (ptr As Object, ofs As Integer) As Byte

Parametry

ptr

Object

Základní adresa v nespravované paměti zdrojového objektu.

ofs

Int32

Další posun bajtu, který se před čtením přidá do parametru ptr .

Návraty

Byte

Bajt přečtený z nespravované paměti na daném posunu.

Atributy

ObsoleteAttribute RequiresDynamicCodeAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus posun bajtů (ofs) vytvoří hodnotu null nebo neplatnou adresu.

ArgumentException

ptr ArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

ReadByte umožňuje přímou interakci s nespravovaným bajtovým polem 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 prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)

ReadByte(IntPtr)

Zdroj:

Marshal.cs

Načte jeden bajt z nespravované paměti.

public:
 static System::Byte ReadByte(IntPtr ptr);

public static byte ReadByte(IntPtr ptr);

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

Byte

Bajt čte z nespravované paměti.

Výjimky

AccessViolationException

ptr není rozpoznaný formát.

nebo

ptr je null.

nebo

ptr je neplatný.

Příklady

Následující příklad vytvoří blok nespravované paměti, zapíše bajt do nespravované paměti, přečte bajt zpět z nespravované paměti a pak 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 bajtovým polem 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 prvků.

Čtení z nerovnaných umístění paměti se podporuje.

Viz také

• Copy(Int32[], Int32, IntPtr, Int32)