Marshal::WriteByte Method (IntPtr, Byte)

.NET Framework (current version)

Writes a single byte value to unmanaged memory.

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

Syntax

public:
[SecurityCriticalAttribute]
static void WriteByte(
	IntPtr ptr,
	unsigned char val
)

Parameters

ptr: Type: System::IntPtr
The address in unmanaged memory to write to.

val: Type: System::Byte
The value to write.

Exceptions

Exception	Condition
AccessViolationException	ptr is not a recognized format. -or- ptr is null. -or- ptr is invalid.

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.

Examples

The following example creates a block of unmanaged memory, writes a byte to the unmanaged memory, reads the byte back from unmanaged memory, and then disposes the unmanaged memory.

C++

No code example is currently available or this language may not be supported.

Security

SecurityCriticalAttribute

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

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1