IntPtr.Add(IntPtr, Int32) Methode

Definition

Fügt einen Offset zu einer signierten ganzzahligen Zahl hinzu.

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

Parameter

pointer
IntPtr

nativeint

Die signierte ganze Zahl, der der Offset hinzugefügt werden soll.

offset
Int32

Der hinzuzufügende Offset.

Gibt zurück

IntPtr

nativeint

Eine neue signierte ganze Zahl, die das Hinzufügen von offsetpointer.

Beispiele

Im folgenden Beispiel wird ein IntPtr Objekt instanziiert, das auf den Anfang eines Zehn-Element-Arrays zeigt, und ruft dann die Add Methode auf, um die Elemente im Array zu durchlaufen.

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
#nowarn "9"
open System
open System.Runtime.InteropServices
open FSharp.NativeInterop

[<EntryPoint>]
let main _ =
    let mutable arr = 
        [| 2; 4; 6; 8; 10; 12; 14; 16; 18; 20 |]
    
    use parr = fixed arr
    
    let ptr = NativePtr.toNativeInt parr

    // Get the size of an array element.
    let size = sizeof<int>
    for i = 0 to arr.Length - 1 do
        let newPtr = IntPtr.Add(ptr, i * size)
        printf $"{Marshal.ReadInt32 newPtr}   "
    0

// 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

Hinweise

Die Add Methode löst keine Ausnahme aus, wenn das Ergebnis zu groß ist, um als signierte ganze Zahl im Ausführungsprozess darzustellen. Stattdessen wird der Additionsvorgang in einem deaktivierten Kontext ausgeführt.

Sprachen, die die Operatorüberladung oder benutzerdefinierte Operatoren nicht unterstützen, können diese Methode verwenden, um einen Offset zum Wert eines Zeigers hinzuzufügen.

Gilt für:

Weitere Informationen