IntPtr.Add(IntPtr, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.