Marshal.WriteByte Method (Object, Int32, Byte)

 

Writes a single byte value to unmanaged memory at a specified offset.

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

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

Parameters

ptr
Type: System.Object

The base address in unmanaged memory of the target object.

ofs
Type: System.Int32

An additional byte offset, which is added to the ptr parameter before writing.

val
Type: System.Byte

The value to write.

Exception Condition
AccessViolationException

Base address (ptr) plus offset byte (ofs) produces a null or invalid address.

ArgumentException

ptr is an ArrayWithOffset object. This method does not accept ArrayWithOffset parameters.

WriteByte enables direct interaction with an unmanaged C-style byte array, eliminating the expense of copying an entire unmanaged array (using Marshal.Copy) to a separate managed array before setting its element values.

SecurityCriticalAttribute

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

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1
Return to top
Show: