Unsafe.Add Metode

Definisi

Ruang nama:

System.Runtime.CompilerServices

Rakitan:

System.Runtime.dll

Paket:

System.Runtime.CompilerServices.Unsafe v6.0.0

Overload

Add<T>(Void*, Int32)	Menambahkan offset elemen ke penunjuk tidak terkelola yang diberikan.
Add<T>(T, Int32)	Menambahkan offset ke penunjuk terkelola yang diberikan.
Add<T>(T, IntPtr)	Menambahkan offset elemen ke penunjuk terkelola yang diberikan.
Add<T>(T, UIntPtr)	Menambahkan offset elemen ke penunjuk terkelola yang diberikan.

Add<T>(Void*, Int32)

Sumber:

Unsafe.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan offset elemen ke penunjuk tidak terkelola yang diberikan.

public:
generic <typename T>
 static void* Add(void* source, int elementOffset);

[System.CLSCompliant(false)]
public static void* Add<T> (void* source, int elementOffset);

[<System.CLSCompliant(false)>]
static member Add : nativeptr<unit> * int -> nativeptr<unit>

Jenis parameter

T

Jenis yang ukurannya akan digunakan sebagai faktor skala untuk elementOffset.

Parameter

source

Void*

Penunjuk tidak terkelola untuk menambahkan offset.

elementOffset

Int32

Offset yang akan ditambahkan.

Mengembalikan

Void*

Penunjuk baru yang tidak dikelola yang mencerminkan penambahan offset yang ditentukan ke penunjuk sumber.

Atribut

CLSCompliantAttribute

Keterangan

Parameter elementOffset adalah jumlah elemen berukuran T(bukan byte) untuk ditambahkan ke penunjuk source . Misalnya, mengingat ptr pointer sumber, panggilan Unsafe.Add<int>(ptr, 20) akan mengembalikan pointer baru yang alamatnya menunjuk 80 byte (= 20 elemen * 4 byte per elemen) di luar ptr.

Jika elementOffset merupakan nilai terhitung daripada harfiah yang dikodekan secara permanen, penelepon harus mempertimbangkan kemungkinan luapan bilangan bulat. Misalnya, dalam panggilan Unsafe.Add<int>(ptr, a * b), pemanggil harus memastikan nilai a * b perantara tidak melebihi batas Int32.

Add<T>(T, Int32)

Sumber:

Unsafe.cs

Menambahkan offset ke penunjuk terkelola yang diberikan.

public:
generic <typename T>
 static T % Add(T % source, int elementOffset);

public static ref T Add<T> (ref T source, int elementOffset);

static member Add : 'T * int -> 'T

Public Shared Function Add(Of T) (ByRef source As T, elementOffset As Integer) As T

Jenis parameter

T

Jenis elemen dari penunjuk terkelola.

Parameter

source

T

Penunjuk terkelola untuk menambahkan offset.

elementOffset

Int32

Offset yang akan ditambahkan.

Mengembalikan

T

Pointer terkelola baru yang mencerminkan penambahan offset yang ditentukan ke penunjuk sumber.

Keterangan

Parameter elementOffset adalah jumlah elemen berukuran T(bukan byte) untuk ditambahkan ke penunjuk source . Misalnya, mengingat ptr pointer sumber jenis ref int, panggilan Unsafe.Add<int>(ref ptr, 20) akan mengembalikan pointer baru yang alamatnya menunjuk 80 byte (= 20 elemen * 4 byte per elemen) di luar ptr.

Jika elementOffset merupakan nilai terhitung daripada harfiah yang dikodekan secara permanen, penelepon harus mempertimbangkan kemungkinan luapan bilangan bulat. Misalnya, dalam panggilan Unsafe.Add<int>(ref ptr, a * b), pemanggil harus memastikan nilai a * b perantara tidak melebihi batas Int32.

Add<T>(T, IntPtr)

Sumber:

Unsafe.cs

Menambahkan offset elemen ke penunjuk terkelola yang diberikan.

public:
generic <typename T>
 static T % Add(T % source, IntPtr elementOffset);

public static ref T Add<T> (ref T source, IntPtr elementOffset);

static member Add : 'T * nativeint -> 'T

Public Shared Function Add(Of T) (ByRef source As T, elementOffset As IntPtr) As T

Jenis parameter

T

Jenis elemen dari penunjuk terkelola.

Parameter

source

T

Penunjuk terkelola untuk menambahkan offset.

elementOffset

IntPtr

nativeint

Offset yang akan ditambahkan.

Mengembalikan

T

Pointer terkelola baru yang mencerminkan penambahan offset yang ditentukan ke penunjuk sumber.

Keterangan

Parameter elementOffset adalah jumlah elemen berukuran T(bukan byte) untuk ditambahkan ke penunjuk source . Misalnya, mengingat ptr pointer sumber jenis ref int, panggilan Unsafe.Add<int>(ref ptr, (nint)20) akan mengembalikan pointer baru yang alamatnya menunjuk 80 byte (= 20 elemen * 4 byte per elemen) di luar ptr.

Jika elementOffset merupakan nilai terhitung daripada harfiah yang dikodekan secara permanen, penelepon harus mempertimbangkan kemungkinan luapan bilangan bulat. Misalnya, dalam panggilan Unsafe.Add<int>(ref ptr, a * b), pemanggil harus memastikan nilai a * b perantara tidak melebihi batas IntPtr.

Add<T>(T, UIntPtr)

Sumber:

Unsafe.cs

Penting

API ini bukan kompatibel CLS.

Menambahkan offset elemen ke penunjuk terkelola yang diberikan.

public:
generic <typename T>
 static T % Add(T % source, UIntPtr elementOffset);

[System.CLSCompliant(false)]
public static ref T Add<T> (ref T source, UIntPtr elementOffset);

[<System.CLSCompliant(false)>]
static member Add : 'T * unativeint -> 'T

Public Shared Function Add(Of T) (ByRef source As T, elementOffset As UIntPtr) As T

Jenis parameter

T

Jenis elemen dari penunjuk terkelola.

Parameter

source

T

Penunjuk terkelola untuk menambahkan offset.

elementOffset

UIntPtr

nuint

unativeint

Offset yang akan ditambahkan.

Mengembalikan

T

Pointer terkelola baru yang mencerminkan penambahan offset yang ditentukan ke penunjuk sumber.

Atribut

CLSCompliantAttribute

Keterangan

Parameter elementOffset adalah jumlah elemen berukuran T(bukan byte) untuk ditambahkan ke penunjuk source . Misalnya, mengingat ptr pointer sumber jenis ref int, panggilan Unsafe.Add<int>(ref ptr, (nuint)20) akan mengembalikan pointer baru yang alamatnya menunjuk 80 byte (= 20 elemen * 4 byte per elemen) di luar ptr.

Jika elementOffset merupakan nilai terhitung daripada harfiah yang dikodekan secara permanen, penelepon harus mempertimbangkan kemungkinan luapan bilangan bulat. Misalnya, dalam panggilan Unsafe.Add<int>(ref ptr, a * b), pemanggil harus memastikan nilai a * b perantara tidak melebihi batas UIntPtr.