Marshal.WriteByte Methode

Definition

Namespace:
System.Runtime.InteropServices
Assemblys:
mscorlib.dll, System.Runtime.InteropServices.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
netstandard.dll

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher.

Überlädt

Name Beschreibung
WriteByte(Object, Int32, Byte)
Veraltet.

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.
WriteByte(IntPtr, Int32, Byte)

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.
WriteByte(IntPtr, Byte)

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher.

WriteByte(Object, Int32, Byte)

Achtung

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

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

public:
 static void WriteByte(System::Object ^ ptr, int ofs, System::Byte val);
[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static void WriteByte(object ptr, int ofs, byte val);
public static void WriteByte(object ptr, int ofs, byte val);
[System.Security.SecurityCritical]
public static void WriteByte(object ptr, int ofs, 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.")>]
[<System.Security.SecurityCritical>]
static member WriteByte : obj * int * byte -> unit
static member WriteByte : obj * int * byte -> unit
[<System.Security.SecurityCritical>]
static member WriteByte : obj * int * byte -> unit
[<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)

Parameter

ptr
Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs
Int32

Ein zusätzlicher Byte-Offset, der dem Parameter vor dem ptr Schreiben hinzugefügt wird.

val
Byte

Der zu schreibende Wert.

Attribute
ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

ArgumentException

ptr ist ein ArrayWithOffset Objekt. Diese Methode akzeptiert ArrayWithOffset keine Parameter.

Hinweise

WriteByte ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Weitere Informationen

Gilt für:

WriteByte(IntPtr, Int32, Byte)

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher bei einem angegebenen Offset.

public:
 static void WriteByte(IntPtr ptr, int ofs, System::Byte val);
[System.Security.SecurityCritical]
public static void WriteByte(IntPtr ptr, int ofs, byte val);
public static void WriteByte(IntPtr ptr, int ofs, byte val);
[<System.Security.SecurityCritical>]
static member WriteByte : nativeint * int * byte -> unit
static member WriteByte : nativeint * int * byte -> unit
Public Shared Sub WriteByte (ptr As IntPtr, ofs As Integer, val As Byte)

Parameter

ptr
IntPtr

nativeint

Die Basisadresse im nicht verwalteten Arbeitsspeicher, in die geschrieben werden soll.

ofs
Int32

Ein zusätzlicher Byte-Offset, der dem Parameter vor dem ptr Schreiben hinzugefügt wird.

val
Byte

Der zu schreibende Wert.

Attribute
SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Basisadresse (ptr) plus Offsetbyte (ofs) erzeugt eine NULL- oder ungültige Adresse.

Beispiele

Im folgenden Beispiel wird das Lesen und Schreiben in ein nicht verwaltetes Array mithilfe der und WriteByte der ReadByte Methoden veranschaulicht.

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

Hinweise

WriteByte ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Weitere Informationen

Gilt für:

WriteByte(IntPtr, Byte)

Schreibt einen einzelnen Bytewert in nicht verwalteten Arbeitsspeicher.

public:
 static void WriteByte(IntPtr ptr, System::Byte val);
[System.Security.SecurityCritical]
public static void WriteByte(IntPtr ptr, byte val);
public static void WriteByte(IntPtr ptr, byte val);
[<System.Security.SecurityCritical>]
static member WriteByte : nativeint * byte -> unit
static member WriteByte : nativeint * byte -> unit
Public Shared Sub WriteByte (ptr As IntPtr, val As Byte)

Parameter

ptr
IntPtr

nativeint

Die Adresse im nicht verwalteten Speicher, in die geschrieben werden soll.

val
Byte

Der zu schreibende Wert.

Attribute
SecurityCriticalAttribute

Ausnahmen

AccessViolationException

ptr ist kein erkanntes Format.

-oder-

ptr ist null.

-oder-

ptr ist ungültig.

Beispiele

Im folgenden Beispiel wird ein Block des nicht verwalteten Speichers erstellt, ein Byte in den nicht verwalteten Speicher geschrieben, das Byte aus nicht verwaltetem Speicher zurückgelesen und anschließend der nicht verwaltete Speicher gelöscht.

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

Hinweise

WriteByte ermöglicht direkte Interaktion mit einem nicht verwalteten C-Bytearray, wodurch die Kosten für das Kopieren eines gesamten nicht verwalteten Arrays (unter Verwendung Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Weitere Informationen

Gilt für: