IntPtr.Add(IntPtr, Int32) Metodo

Definizione

Aggiunge un offset al valore di un puntatore.Adds an offset to the value of a pointer.

public:
 static IntPtr Add(IntPtr pointer, int offset);
public static IntPtr Add (IntPtr pointer, int offset);
static member Add : nativeint * int -> nativeint
Public Shared Function Add (pointer As IntPtr, offset As Integer) As IntPtr

Parametri

pointer
IntPtr

Puntatore a cui aggiungere l'offset.The pointer to add the offset to.

offset
Int32

Offset da aggiungere.The offset to add.

Restituisce

Nuovo puntatore che riflette l'aggiunta di offset a pointer.A new pointer that reflects the addition of offset to pointer.

Esempi

Nell'esempio seguente viene creata un' IntPtr istanza di un oggetto che punta all'inizio di una matrice di dieci elementi, quindi chiama Add il metodo per eseguire l'iterazione degli elementi nella matrice.The following example instantiates an IntPtr object that points to the beginning of a ten-element array, and then calls the Add method to iterate the elements in the array.

using System;
using System.Runtime.InteropServices;

public class Example
{
   public static void Main()
   {
      int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
      unsafe {
         fixed(int* parr = arr) {
            IntPtr ptr = new IntPtr(parr);
            // Get the size of an array element.
            int size = sizeof(int);
            for (int ctr = 0; ctr < arr.Length; ctr++)
            {
               IntPtr newPtr = IntPtr.Add(ptr, ctr * size);
               Console.Write("{0}   ", Marshal.ReadInt32(newPtr));
            }
         }      
      }
   }
}
// The example displays the following output:
//       2   4   6   8   10   12   14   16   18   20
Imports System.Runtime.InteropServices

Module Example
   Public Sub Main()
      Dim arr() As Integer = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 }
      Dim ptr As IntPtr = Marshal.UnsafeAddrOfPinnedArrayElement(arr, 0)

      For ctr As Integer= 0 To arr.Length - 1
         Dim newPtr As IntPtr = IntPtr.Add(ptr, ctr * Len(arr(0)))
         Console.Write("{0}   ", Marshal.ReadInt32(newPtr))
      Next
   End Sub
End Module
' The example displays the following output:
'       2   4   6   8   10   12   14   16   18   20

Commenti

Il Add metodo non genera un'eccezione se il risultato è troppo grande per essere rappresentato come puntatore sulla piattaforma specificata.The Add method does not throw an exception if the result is too large to represent as a pointer on the specified platform. Al contrario, l'operazione di addizione viene eseguita in un contesto non controllato.Instead, the addition operation is performed in an unchecked context.

I linguaggi che non supportano l'overload degli operatori o gli operatori personalizzati possono utilizzare questo metodo per aggiungere un offset al valore di un puntatore.Languages that do not support operator overloading or custom operators can use this method to add an offset to the value of a pointer.

Si applica a

Vedi anche