Marshal::WriteByte Method (Object^, Int32, Byte)
Writes a single byte value to unmanaged memory at a specified offset.
Assembly: mscorlib (in mscorlib.dll)
public: [SecurityCriticalAttribute] static void WriteByte( Object^ ptr, int ofs, unsigned char val )
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.
requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1