Bagikan melalui


Marshal.ReadByte Metode

Definisi

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
Sumber:
Marshal.cs
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);
[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

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 yang dibaca dari memori tidak terkelola pada offset yang diberikan.

Atribut

Pengecualian

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

Berlaku untuk

ReadByte(Object, Int32)

Sumber:
Marshal.CoreCLR.cs
Sumber:
Marshal.CoreCLR.cs
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.")]
[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

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 yang dibaca dari memori tidak terkelola pada offset yang diberikan.

Atribut

Pengecualian

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

ptr ArrayWithOffset 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

Berlaku untuk

ReadByte(IntPtr)

Sumber:
Marshal.cs
Sumber:
Marshal.cs
Sumber:
Marshal.cs

Membaca satu byte dari memori yang tidak dikelola.

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

Parameter

ptr
IntPtr

nativeint

Alamat dalam memori yang tidak terkelola untuk dibaca.

Mengembalikan

Byte yang dibaca dari memori yang tidak dikelola.

Atribut

Pengecualian

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

Berlaku untuk