Marshal.ReadByte Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Membaca satu byte dari memori yang tidak dikelola. Membaca dari lokasi memori yang tidak sejajar didukung.

Overload

ReadByte(IntPtr, Int32)	Membaca byte tunggal pada offset (atau indeks) tertentu dari memori yang tidak dikelola.
ReadByte(Object, Int32)	Kedaluwarsa. Membaca byte tunggal pada offset (atau indeks) tertentu dari memori yang tidak dikelola.
ReadByte(IntPtr)	Membaca satu byte dari memori yang tidak dikelola.

ReadByte(IntPtr, Int32)

Sumber:

Marshal.cs

Membaca byte tunggal pada offset (atau indeks) tertentu dari memori yang tidak dikelola.

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

Parameter

ptr

IntPtr

nativeint

Alamat dasar dalam memori yang tidak dikelola untuk dibaca.

ofs

Int32

Offset byte tambahan, yang ditambahkan ke ptr parameter sebelum membaca.

Mengembalikan

Byte

Byte yang dibaca dari memori tidak terkelola pada offset yang diberikan.

Pengecualian

AccessViolationException

Alamat dasar (ptr) ditambah byte offset (ofs) menghasilkan alamat null atau tidak valid.

Contoh

Contoh berikut menunjukkan cara membaca dan menulis ke array yang tidak dikelola menggunakan ReadByte metode dan 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

Contoh berikut menunjukkan cara menggunakan ReadByte metode untuk membaca nilai karakter yang tidak dikelola.

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);
}

Keterangan

ReadByte memungkinkan interaksi langsung dengan array byte gaya C yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak sejajar didukung.

Lihat juga

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

ReadByte(Object, Int32)

Sumber:

Marshal.CoreCLR.cs

Perhatian

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

Membaca byte tunggal pada offset (atau indeks) tertentu dari memori yang tidak dikelola.

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

Parameter

ptr

Object

Alamat dasar dalam memori objek sumber yang tidak dikelola.

ofs

Int32

Offset byte tambahan, yang ditambahkan ke ptr parameter sebelum membaca.

Mengembalikan

Byte

Byte yang dibaca dari memori tidak terkelola pada offset yang diberikan.

Atribut

ObsoleteAttribute

Pengecualian

AccessViolationException

Alamat dasar (ptr) ditambah byte offset (ofs) menghasilkan alamat null atau tidak valid.

ArgumentException

ptrArrayWithOffset adalah objek . Metode ini tidak menerima ArrayWithOffset parameter.

Keterangan

ReadByte memungkinkan interaksi langsung dengan array byte gaya C yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak sejajar didukung.

Lihat juga

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

ReadByte(IntPtr)

Sumber:

Marshal.cs

Membaca satu byte dari memori yang tidak dikelola.

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

Parameter

ptr

IntPtr

nativeint

Alamat dalam memori yang tidak terkelola untuk dibaca.

Mengembalikan

Byte

Byte yang dibaca dari memori yang tidak dikelola.

Pengecualian

AccessViolationException

ptr bukan format yang dikenali.

-atau-

ptradalah null.

-atau-

ptr tidak valid.

Contoh

Contoh berikut membuat blok memori yang tidak dikelola, menulis byte ke memori yang tidak dikelola, membaca byte kembali dari memori yang tidak dikelola, lalu membuang memori yang tidak dikelola.

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

Contoh berikut menunjukkan cara menggunakan ReadByte metode untuk membaca nilai karakter yang tidak dikelola.

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);
}

Keterangan

ReadByte memiliki offset tersirat 0. Metode ini memungkinkan interaksi langsung dengan array byte gaya C yang tidak dikelola, menghilangkan pengeluaran menyalin seluruh array yang tidak dikelola (menggunakan Marshal.Copy) ke array terkelola terpisah sebelum membaca nilai elemennya.

Membaca dari lokasi memori yang tidak sejajar didukung.

Lihat juga

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