Marshal.ReadByte Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Yönetilmeyen bellekten tek bir bayt okur. Hizalanmamış bellek konumlarından okuma desteklenir.

Aşırı Yüklemeler

Name	Description
ReadByte(IntPtr, Int32)	Yönetilmeyen bellekten belirli bir uzaklıkta (veya dizinde) tek bir bayt okur.
ReadByte(Object, Int32)	Geçersiz. Yönetilmeyen bellekten belirli bir uzaklıkta (veya dizinde) tek bir bayt okur.
ReadByte(IntPtr)	Yönetilmeyen bellekten tek bir bayt okur.

ReadByte(IntPtr, Int32)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten belirli bir uzaklıkta (veya dizinde) tek bir bayt okur.

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

Parametreler

ptr

IntPtr

nativeint

Yönetilmeyen bellekte okuması gereken temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Byte

Bayt, verilen uzaklıkta yönetilmeyen bellekten okunur.

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

Örnekler

Aşağıdaki örnek, ve ReadByte yöntemlerini kullanarak WriteByte yönetilmeyen bir diziyi nasıl okuyup yazacaklarını gösterir.

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

Aşağıdaki örnek, yönetilmeyen bir karakterin ReadByte değerini okumak için yönteminin nasıl kullanılacağını gösterir.

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

Açıklamalar

ReadByte yönetilmeyen bir C stili bayt dizisiyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalama masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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

ReadByte(Object, Int32)

Kaynak:

Marshal.CoreCLR.cs

Dikkat

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

Yönetilmeyen bellekten belirli bir uzaklıkta (veya dizinde) tek bir bayt okur.

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

Parametreler

ptr

Object

Kaynak nesnenin yönetilmeyen belleğindeki temel adres.

ofs

Int32

Okumadan önce parametresine ptr eklenen ek bir bayt uzaklığı.

Döndürülenler

Byte

Bayt, verilen uzaklıkta yönetilmeyen bellekten okunur.

Öznitelikler

ObsoleteAttribute RequiresDynamicCodeAttribute

Özel durumlar

AccessViolationException

Temel adres (ptr) artı uzaklık bayt (ofs) null veya geçersiz bir adres üretir.

ArgumentException

ptr bir ArrayWithOffset nesnedir. Bu yöntem parametreleri kabul ArrayWithOffset etmez.

Açıklamalar

ReadByte yönetilmeyen bir C stili bayt dizisiyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalama masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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

ReadByte(IntPtr)

Kaynak:

Marshal.cs

Yönetilmeyen bellekten tek bir bayt okur.

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

Parametreler

ptr

IntPtr

nativeint

Yönetilmeyen bellekte okunacak adres.

Döndürülenler

Byte

Yönetilmeyen bellekten okunan bayt.

Özel durumlar

AccessViolationException

ptr tanınan bir biçim değildir.

-veya-

ptr, null'e eşittir.

-veya-

ptr geçersiz.

Örnekler

Aşağıdaki örnek yönetilmeyen bellek bloğu oluşturur, yönetilmeyen belleğe bir bayt yazar, yönetilmeyen bellekten bayt'ı geri okur ve yönetilmeyen belleği atmaktadır.

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

Aşağıdaki örnek, yönetilmeyen bir karakterin ReadByte değerini okumak için yönteminin nasıl kullanılacağını gösterir.

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

Açıklamalar

ReadByte 0 zımni uzaklığı vardır. Bu yöntem yönetilmeyen bir C stili bayt dizisiyle doğrudan etkileşime olanak sağlayarak, öğe değerlerini okumadan önce yönetilmeyen dizinin tamamını (kullanarak Marshal.Copy) ayrı bir yönetilen diziye kopyalamanın masrafını ortadan kaldırır.

Hizalanmamış bellek konumlarından okuma desteklenir.

Ayrıca bkz.

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