Marshal.WriteByte Methode

Definitie

Naamruimte:: System.Runtime.InteropServices

Assembly's:: mscorlib.dll, System.Runtime.InteropServices.dll

Assembly's:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee schrijft u één bytewaarde naar onbeheerd geheugen.

Overloads

Name	Description
WriteByte(Object, Int32, Byte)	Verouderd. Hiermee schrijft u één bytewaarde naar onbeheerd geheugen op een opgegeven offset.
WriteByte(IntPtr, Byte)	Hiermee schrijft u één bytewaarde naar onbeheerd geheugen.
WriteByte(IntPtr, Int32, Byte)	Hiermee schrijft u één bytewaarde naar onbeheerd geheugen op een opgegeven offset.

WriteByte(Object, Int32, Byte)

Bron:: Marshal.CoreCLR.cs

Bron:: Marshal.CoreCLR.cs

Bron:: Marshal.CoreCLR.cs

Bron:: Marshal.CoreCLR.cs

Bron:: Marshal.CoreCLR.cs

Let op

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

Hiermee schrijft u één bytewaarde naar onbeheerd geheugen op een opgegeven 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);

[System.Obsolete("WriteByte(Object, Int32, Byte) may be unavailable in future releases.")]
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")]
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.")>]
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the object might not be available")>]
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)

Parameters

ptr: Object

Het basisadres in het niet-beheerde geheugen van het doelobject.

ofs: Int32

Een extra byte-offset, die wordt toegevoegd aan de ptr parameter voordat u schrijft.

val: Byte

De waarde die moet worden geschreven.

Kenmerken: ObsoleteAttribute SecurityCriticalAttribute RequiresDynamicCodeAttribute

Uitzonderingen

AccessViolationException

Basisadres (ptr) plus offset byte (ofs) produceert een null- of ongeldig adres.

ArgumentException

ptr is een ArrayWithOffset object. Deze methode accepteert ArrayWithOffset geen parameters.

Opmerkingen

WriteByte 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 ingesteld.

Zie ook

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

Van toepassing op

WriteByte(IntPtr, Byte)

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Hiermee schrijft u één bytewaarde naar onbeheerd geheugen.

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)

Parameters

ptr: IntPtr
nativeint

Het adres in onbeheerd geheugen waarnaar moet worden geschreven.

val: Byte

De waarde die moet worden geschreven.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

AccessViolationException

ptr is geen herkende indeling.

– of –

ptr is null.

– of –

ptr is ongeldig.

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

Opmerkingen

Zie ook

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

Van toepassing op

WriteByte(IntPtr, Int32, Byte)

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Bron:: Marshal.cs

Hiermee schrijft u één bytewaarde naar onbeheerd geheugen op een opgegeven 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)

Parameters

ptr: IntPtr
nativeint

Het basisadres in niet-beheerd geheugen waarnaar moet worden geschreven.

ofs: Int32

Een extra byte-offset, die wordt toegevoegd aan de ptr parameter voordat u schrijft.

val: Byte

De waarde die moet worden geschreven.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

AccessViolationException

Basisadres (ptr) plus offset byte (ofs) produceert een null- of ongeldig adres.

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

Opmerkingen

Zie ook

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

Van toepassing op

Feedback

Is deze pagina nuttig?