Unsafe.Add Méthode

Définition

Espace de noms:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Surcharges

Add<T>(Void*, Int32)	Ajoute un décalage d’élément au pointeur non managé donné.
Add<T>(T, Int32)	Ajoute un décalage au pointeur managé donné.
Add<T>(T, IntPtr)	Ajoute un décalage d’élément au pointeur managé donné.
Add<T>(T, UIntPtr)	Ajoute un décalage d’élément au pointeur managé donné.

Add<T>(Void*, Int32)

Source:

Unsafe.cs

Important

Cette API n’est pas conforme CLS.

Ajoute un décalage d’élément au pointeur non managé donné.

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>

Paramètres de type

T

Type dont la taille sera utilisée comme facteur d’échelle pour elementOffset.

Paramètres

source

Void*

Pointeur non managé auquel ajouter le décalage.

elementOffset

Int32

Offset à ajouter.

Retours

Void*

Nouveau pointeur non managé qui reflète l’ajout du décalage spécifié au pointeur source.

Attributs

CLSCompliantAttribute

Remarques

Le elementOffset paramètre est le nombre d’éléments Tde taille (et non d’octets) à ajouter au source pointeur. Par exemple, avec un pointeur source ptr, l’appel Unsafe.Add<int>(ptr, 20) retourne un nouveau pointeur dont l’adresse pointe 80 octets (= 20 éléments * 4 octets par élément) au-delà de ptr.

Si elementOffset est une valeur calculée plutôt qu’un littéral codé en dur, les appelants doivent envisager la possibilité d’un dépassement de capacité d’entier. Par exemple, dans l’appel Unsafe.Add<int>(ptr, a * b), l’appelant doit s’assurer que la valeur a * b intermédiaire ne dépasse pas les limites de Int32.

Add<T>(T, Int32)

Source:

Unsafe.cs

Ajoute un décalage au pointeur managé donné.

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

Paramètres de type

T

Type élémentaire du pointeur managé.

Paramètres

source

T

Pointeur managé auquel ajouter le décalage.

elementOffset

Int32

Offset à ajouter.

Retours

T

Nouveau pointeur managé qui reflète l’ajout du décalage spécifié au pointeur source.

Remarques

Le elementOffset paramètre est le nombre d’éléments Tde taille (et non d’octets) à ajouter au source pointeur. Par exemple, avec un pointeur source ptr de type ref int, l’appel Unsafe.Add<int>(ref ptr, 20) retourne un nouveau pointeur dont l’adresse pointe 80 octets (= 20 éléments * 4 octets par élément) au-delà de ptr.

Si elementOffset est une valeur calculée plutôt qu’un littéral codé en dur, les appelants doivent envisager la possibilité d’un dépassement de capacité d’entier. Par exemple, dans l’appel Unsafe.Add<int>(ref ptr, a * b), l’appelant doit s’assurer que la valeur a * b intermédiaire ne dépasse pas les limites de Int32.

Add<T>(T, IntPtr)

Source:

Unsafe.cs

Ajoute un décalage d’élément au pointeur managé donné.

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

Paramètres de type

T

Type élémentaire du pointeur managé.

Paramètres

source

T

Pointeur managé auquel ajouter le décalage.

elementOffset

IntPtr

nativeint

Offset à ajouter.

Retours

T

Nouveau pointeur managé qui reflète l’ajout du décalage spécifié au pointeur source.

Remarques

Le elementOffset paramètre est le nombre d’éléments Tde taille (et non d’octets) à ajouter au source pointeur. Par exemple, avec un pointeur source ptr de type ref int, l’appel Unsafe.Add<int>(ref ptr, (nint)20) retourne un nouveau pointeur dont l’adresse pointe 80 octets (= 20 éléments * 4 octets par élément) au-delà de ptr.

Si elementOffset est une valeur calculée plutôt qu’un littéral codé en dur, les appelants doivent envisager la possibilité d’un dépassement de capacité d’entier. Par exemple, dans l’appel Unsafe.Add<int>(ref ptr, a * b), l’appelant doit s’assurer que la valeur a * b intermédiaire ne dépasse pas les limites de IntPtr.

Add<T>(T, UIntPtr)

Source:

Unsafe.cs

Important

Cette API n’est pas conforme CLS.

Ajoute un décalage d’élément au pointeur managé donné.

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

Paramètres de type

T

Type élémentaire du pointeur managé.

Paramètres

source

T

Pointeur managé auquel ajouter le décalage.

elementOffset

UIntPtr

nuint

unativeint

Offset à ajouter.

Retours

T

Nouveau pointeur managé qui reflète l’ajout du décalage spécifié au pointeur source.

Attributs

CLSCompliantAttribute

Remarques

Le elementOffset paramètre est le nombre d’éléments Tde taille (et non d’octets) à ajouter au source pointeur. Par exemple, avec un pointeur source ptr de type ref int, l’appel Unsafe.Add<int>(ref ptr, (nuint)20) retourne un nouveau pointeur dont l’adresse pointe 80 octets (= 20 éléments * 4 octets par élément) au-delà de ptr.

Si elementOffset est une valeur calculée plutôt qu’un littéral codé en dur, les appelants doivent envisager la possibilité d’un dépassement de capacité d’entier. Par exemple, dans l’appel Unsafe.Add<int>(ref ptr, a * b), l’appelant doit s’assurer que la valeur a * b intermédiaire ne dépasse pas les limites de UIntPtr.