UnmanagedMemoryAccessor.Write 方法

定义

命名空间:

System.IO

程序集:

mscorlib.dll, System.IO.UnmanagedMemoryStream.dll

程序集:

System.Runtime.InteropServices.dll

程序集:

System.IO.UnmanagedMemoryStream.dll

程序集:

mscorlib.dll

程序集:

netstandard.dll

将一个值写入访问器。

重载

Write(Int64, UInt64)	将一个 64 位无符号整数写入访问器。
Write(Int64, UInt32)	将一个 32 位无符号整数写入访问器。
Write(Int64, UInt16)	将一个 16 位无符号整数写入访问器。
Write(Int64, Single)	将一个 Single 写入访问器。
Write(Int64, SByte)	将一个 8 位整数写入访问器。
Write(Int64, Int64)	将一个 64 位整数写入访问器。
Write(Int64, Double)	将一个 Double 值写入访问器。
Write(Int64, Int16)	将一个 16 位整数写入访问器。
Write(Int64, Decimal)	将一个小数值写入访问器。
Write(Int64, Char)	将一个字符写入访问器。
Write(Int64, Byte)	将一个字节值写入访问器。
Write(Int64, Boolean)	将一个布尔值写入访问器。
Write(Int64, Int32)	将一个 32 位整数写入访问器。
Write<T>(Int64, T)	将一个结构写入访问器。

Write(Int64, UInt64)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案

System.Decimal

将一个 64 位无符号整数写入访问器。

public:
 void Write(long position, System::UInt64 value);

[System.CLSCompliant(false)]
public void Write (long position, ulong value);

[<System.CLSCompliant(false)>]
member this.Write : int64 * uint64 -> unit

Public Sub Write (position As Long, value As ULong)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

UInt64

要写入的值。

属性

CLSCompliantAttribute

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, UInt32)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案

System.Int64

将一个 32 位无符号整数写入访问器。

public:
 void Write(long position, System::UInt32 value);

[System.CLSCompliant(false)]
public void Write (long position, uint value);

[<System.CLSCompliant(false)>]
member this.Write : int64 * uint32 -> unit

Public Sub Write (position As Long, value As UInteger)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

UInt32

要写入的值。

属性

CLSCompliantAttribute

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, UInt16)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案

System.Int32

将一个 16 位无符号整数写入访问器。

public:
 void Write(long position, System::UInt16 value);

[System.CLSCompliant(false)]
public void Write (long position, ushort value);

[<System.CLSCompliant(false)>]
member this.Write : int64 * uint16 -> unit

Public Sub Write (position As Long, value As UShort)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

UInt16

要写入的值。

属性

CLSCompliantAttribute

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Single)

将一个 Single 写入访问器。

public:
 void Write(long position, float value);

public void Write (long position, float value);

member this.Write : int64 * single -> unit

Public Sub Write (position As Long, value As Single)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Single

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, SByte)

重要

此 API 不符合 CLS。

符合 CLS 的替代方案

System.Int16

将一个 8 位整数写入访问器。

public:
 void Write(long position, System::SByte value);

[System.CLSCompliant(false)]
public void Write (long position, sbyte value);

[<System.CLSCompliant(false)>]
member this.Write : int64 * sbyte -> unit

Public Sub Write (position As Long, value As SByte)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

SByte

要写入的值。

属性

CLSCompliantAttribute

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Int64)

将一个 64 位整数写入访问器。

public:
 void Write(long position, long value);

public void Write (long position, long value);

member this.Write : int64 * int64 -> unit

Public Sub Write (position As Long, value As Long)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Int64

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Double)

将一个 Double 值写入访问器。

public:
 void Write(long position, double value);

public void Write (long position, double value);

member this.Write : int64 * double -> unit

Public Sub Write (position As Long, value As Double)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Double

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Int16)

将一个 16 位整数写入访问器。

public:
 void Write(long position, short value);

public void Write (long position, short value);

member this.Write : int64 * int16 -> unit

Public Sub Write (position As Long, value As Short)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Int16

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Decimal)

将一个小数值写入访问器。

public:
 void Write(long position, System::Decimal value);

public void Write (long position, decimal value);

member this.Write : int64 * decimal -> unit

Public Sub Write (position As Long, value As Decimal)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Decimal

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

• 或 - 小数无效。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Char)

将一个字符写入访问器。

public:
 void Write(long position, char value);

public void Write (long position, char value);

member this.Write : int64 * char -> unit

Public Sub Write (position As Long, value As Char)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Char

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Byte)

将一个字节值写入访问器。

public:
 void Write(long position, System::Byte value);

public void Write (long position, byte value);

member this.Write : int64 * byte -> unit

Public Sub Write (position As Long, value As Byte)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Byte

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Boolean)

将一个布尔值写入访问器。

public:
 void Write(long position, bool value);

public void Write (long position, bool value);

member this.Write : int64 * bool -> unit

Public Sub Write (position As Long, value As Boolean)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Boolean

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write(Int64, Int32)

将一个 32 位整数写入访问器。

public:
 void Write(long position, int value);

public void Write (long position, int value);

member this.Write : int64 * int -> unit

Public Sub Write (position As Long, value As Integer)

参数

position

Int64

访问器中起始写入位置的字节偏移量。

value

Int32

要写入的值。

例外

ArgumentException

position 后面没有足够的字节数可供写入值。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

Write<T>(Int64, T)

将一个结构写入访问器。

public:
generic <typename T>
 where T : value class void Write(long position, T % structure);

public void Write<T> (long position, ref T structure) where T : struct;

[System.Security.SecurityCritical]
public void Write<T> (long position, ref T structure) where T : struct;

member this.Write : int64 * 'T -> unit (requires 'T : struct)

[<System.Security.SecurityCritical>]
member this.Write : int64 * 'T -> unit (requires 'T : struct)

Public Sub Write(Of T As Structure) (position As Long, ByRef structure As T)

类型参数

T

结构的类型。

参数

position

Int64

访问器中起始写入位置的字节偏移量。

structure

T

要写入的结构。

属性

SecurityCriticalAttribute

例外

ArgumentException

取值函数的 position 后面没有足够的字节数可供写入 T 类型的结构。

ArgumentOutOfRangeException

position 小于零或大于访问器的容量。

NotSupportedException

访问器不支持写入。

ObjectDisposedException

已释放访问器。

注解

使用此方法可将中等结构写入大型结构，而此类中的其他 Write 方法也不容易容纳这些结构。