Marshal.WriteByte-Methode: (Object, Int32, Byte)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

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

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

[SecurityCriticalAttribute]
public static void WriteByte(
    object ptr,
    int ofs,
    byte val
)

public:
[SecurityCriticalAttribute]
static void WriteByte(
    Object^ ptr,
    int ofs,
    unsigned char val
)

[<SecurityCriticalAttribute>]
static member WriteByte : 
        ptr:Object *
        ofs:int *
        val:byte -> unit

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

Parameter

ptr
Type: System.Object

Die Basisadresse im nicht verwalteten Speicher des Zielobjekts.

ofs
Type: System.Int32

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

val
Type: System.Byte

Der zu schreibende Wert.

Ausnahmen

Exception	Condition
AccessViolationException	Basisadresse (ptr) plus offset Byte (ofs) null oder eine ungültige Adresse erzeugt.
ArgumentException	ptr ist ein ArrayWithOffset-Objekt. Diese Methode akzeptiert keine ArrayWithOffset Parameter.

Hinweise

WriteByte ermöglicht die direkte Interaktion mit einem nicht verwalteten C-Stil-Bytearray, sodass ein nicht verwaltetes Array kopiert (mit Marshal.Copy) in ein separates verwaltetes Array vor Elementwerte.

Sicherheit

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone
Verfügbar seit 8.1

Siehe auch

Copy
WriteByte Überladen
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang

Freigeben über