Marshal.WriteByte Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt einen einzelnen Bytewert in den nicht verwalteten Speicher.

Überlädt

WriteByte(Object, Int32, Byte)	Veraltet. Schreibt einen einzelnen Bytewert an einem angegebenen Offset in den nicht verwalteten Arbeitsspeicher.
WriteByte(IntPtr, Byte)	Schreibt einen einzelnen Bytewert in den nicht verwalteten Speicher.
WriteByte(IntPtr, Int32, Byte)	Schreibt einen einzelnen Bytewert an einem angegebenen Offset in den nicht verwalteten Arbeitsspeicher.

WriteByte(Object, Int32, Byte)

Achtung

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

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

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

[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
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.")>]
[<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

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

[<System.Security.SecurityCritical>]
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 Byteoffset, der dem ptr-Parameter vor dem Schreiben hinzugefügt wird.

val: Byte

Der zu schreibende Wert.

Attribute: ObsoleteAttribute SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

ArgumentException

ptr ist ein ArrayWithOffset-Objekt. Diese Methode akzeptiert keine ArrayWithOffset-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 (mithilfe von Marshal.Copy) in ein separates verwaltetes Array vermieden werden, bevor die Elementwerte festgelegt werden.

Siehe auch

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

Gilt für

WriteByte(IntPtr, Byte)

Schreibt einen einzelnen Bytewert in den nicht verwalteten Speicher.

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 Arbeitsspeichers erstellt, ein Byte in den nicht verwalteten Arbeitsspeicher geschrieben, das Byte aus nicht verwaltetem Arbeitsspeicher zurückgelesen und dann der nicht verwaltete Arbeitsspeicher 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

Siehe auch

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

Gilt für

WriteByte(IntPtr, Int32, Byte)

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

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 Speicher, in die geschrieben werden soll.

ofs: Int32

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

val: Byte

Der zu schreibende Wert.

Attribute: SecurityCriticalAttribute

Ausnahmen

AccessViolationException

Die Basisadresse (ptr) und das Offsetbyte (ofs) erzeugen NULL oder eine ungültige Adresse.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ReadByte Methoden WriteByte ein nicht verwaltetes Array lesen und in ein nicht verwaltetes Array schreiben.

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

Siehe auch

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

Gilt für

Marshal.WriteByte Methode

Definition

Überlädt

WriteByte(Object, Int32, Byte)

Parameter

Ausnahmen

Hinweise

Siehe auch

Gilt für

WriteByte(IntPtr, Byte)

Parameter

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

WriteByte(IntPtr, Int32, Byte)

Parameter

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

Zusätzliche Ressourcen