Marshal.WriteByte Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Zapíše hodnotu jednoho bajtu do nespravované paměti.

Přetížení

WriteByte(Object, Int32, Byte)	Zastaralé. Zapíše hodnotu jednoho bajtu do nespravované paměti při zadaném posunu.
WriteByte(IntPtr, Byte)	Zapíše hodnotu jednoho bajtu do nespravované paměti.
WriteByte(IntPtr, Int32, Byte)	Zapíše hodnotu jednoho bajtu do nespravované paměti při zadaném posunu.

WriteByte(Object, Int32, Byte)

Zdroj:

Marshal.CoreCLR.cs

Upozornění

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

Zapíše hodnotu jednoho bajtu do nespravované paměti při zadaném posunu.

public:
 static void WriteByte(System::Object ^ ptr, int ofs, System::Byte val);

[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
public static void WriteByte (object ptr, int ofs, byte val);

[<System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")>]
static member WriteByte : obj * int * byte -> unit

Public Shared Sub WriteByte (ptr As Object, ofs As Integer, val As Byte)

Parametry

ptr

Object

Základní adresa v nespravované paměti cílového objektu.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Byte

Hodnota pro zápis

Atributy

ObsoleteAttribute

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

ArgumentException

ptrArrayWithOffset je objekt. Tato metoda nepřijímá ArrayWithOffset parametry.

Poznámky

WriteByte umožňuje přímou interakci s nespravovaným polem bajtů ve stylu C, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot jeho prvků.

Viz také

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

WriteByte(IntPtr, Byte)

Zdroj:

Marshal.cs

Zapíše hodnotu jednoho bajtu do nespravované paměti.

public:
 static void WriteByte(IntPtr ptr, System::Byte val);

public static void WriteByte (IntPtr ptr, byte val);

static member WriteByte : nativeint * byte -> unit

Public Shared Sub WriteByte (ptr As IntPtr, val As Byte)

Parametry

ptr

IntPtr

nativeint

Adresa v nespravované paměti, na kterou se má zapisovat.

val

Byte

Hodnota pro zápis

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, přečte bajt zpět z nespravované paměti a pak 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

Poznámky

WriteByte umožňuje přímou interakci s nespravovaným polem bajtů ve stylu C, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot jeho prvků.

Viz také

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

WriteByte(IntPtr, Int32, Byte)

Zdroj:

Marshal.cs

Zapíše hodnotu jednoho bajtu do nespravované paměti při zadaném posunu.

public:
 static void WriteByte(IntPtr ptr, int ofs, System::Byte val);

public static void WriteByte (IntPtr ptr, int ofs, byte val);

static member WriteByte : nativeint * int * byte -> unit

Public Shared Sub WriteByte (ptr As IntPtr, ofs As Integer, val As Byte)

Parametry

ptr

IntPtr

nativeint

Základní adresa v nespravované paměti, na kterou se má zapisovat.

ofs

Int32

Další posun bajtů, který se přidá do parametru před zápisem ptr .

val

Byte

Hodnota pro zápis

Výjimky

AccessViolationException

Základní adresa (ptr) plus odsazení bajtu (ofs) vytvoří null nebo neplatnou adresu.

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

Poznámky

WriteByte umožňuje přímou interakci s nespravovaným polem bajtů ve stylu C, čímž eliminuje náklady na kopírování celého nespravovaného pole (pomocí Marshal.Copy) do samostatného spravovaného pole před nastavením hodnot jeho prvků.

Viz také

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