Marshal.ReadByte Methode

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

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

Parameters

Retouren

De byte gelezen uit onbeheerd geheugen op de opgegeven offset.

Kenmerken

SecurityCriticalAttribute

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u met behulp van de ReadByte en WriteByte methoden kunt lezen en schrijven naar een onbeheerde matrix.

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

In het volgende voorbeeld ziet u hoe u de ReadByte methode gebruikt om de waarde van een onbeheerd teken te lezen.

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

Opmerkingen

ReadByte maakt directe interactie mogelijk met een niet-beheerde bytematrix in C-stijl, waardoor de kosten van het kopiëren van een hele onbeheerde matrix (met behulp) Marshal.Copynaar een afzonderlijke beheerde matrix worden geëlimineerd voordat de elementwaarden worden gelezen.

Lezen vanaf niet-uitgelijnde geheugenlocaties wordt ondersteund.

Zie ook

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

Bron:

Marshal.CoreCLR.cs

Bron:

Marshal.CoreCLR.cs

Bron:

Marshal.CoreCLR.cs

Bron:

Marshal.CoreCLR.cs

Bron:

Marshal.CoreCLR.cs

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.")]
[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.")]
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.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
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

Parameters

Retouren

De byte gelezen uit onbeheerd geheugen op de opgegeven offset.

Kenmerken

ObsoleteAttribute SecurityCriticalAttribute RequiresDynamicCodeAttribute

Uitzonderingen

Opmerkingen

ReadByte maakt directe interactie mogelijk met een niet-beheerde bytematrix in C-stijl, waardoor de kosten van het kopiëren van een hele onbeheerde matrix (met behulp) Marshal.Copynaar een afzonderlijke beheerde matrix worden geëlimineerd voordat de elementwaarden worden gelezen.

Lezen vanaf niet-uitgelijnde geheugenlocaties wordt ondersteund.

Zie ook

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

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

Bron:

Marshal.cs

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

Parameters

Retouren

De byte gelezen uit onbeheerd geheugen.

Kenmerken

SecurityCriticalAttribute

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een blok onbeheerd geheugen gemaakt, wordt een byte naar het onbeheerde geheugen geschreven, wordt de byte teruggelezen van onbeheerd geheugen en wordt het onbeheerde geheugen verwijderd.

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

In het volgende voorbeeld ziet u hoe u de ReadByte methode gebruikt om de waarde van een onbeheerd teken te lezen.

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

Opmerkingen

ReadByte heeft een impliciete offset van 0. Deze methode maakt directe interactie mogelijk met een niet-beheerde bytematrix in C-stijl, waardoor de kosten van het kopiëren van een hele onbeheerde matrix (met behulp van Marshal.Copy) naar een afzonderlijke beheerde matrix worden geëlimineerd voordat de elementwaarden worden gelezen.

Lezen vanaf niet-uitgelijnde geheugenlocaties wordt ondersteund.

Zie ook

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