Marshal.ReadByte Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

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

Načte jeden bajt při 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 bajtů, který se přidá do parametru ptr před čtením.

Návraty

Byte

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

Výjimky

AccessViolationException

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é

• 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 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.")]
public static byte ReadByte (object ptr, int ofs);

[<System.Obsolete("ReadByte(Object, Int32) may be unavailable in future releases.")>]
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

Byte

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

Atributy

ObsoleteAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) a posunutého bajtu (ofs) vytváří adresu s hodnotou null nebo neplatnou.

ArgumentException

ptrArrayWithOffset 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é

• 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 přečtený z nespravované paměti.

Výjimky

AccessViolationException

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é

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