IntPtr.Add(IntPtr, Int32) Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 Offset, der addiert werden soll.

Gibt zurück

IntPtr nativeint

Eine neue signierte ganze Zahl, die die Ergänzung zu offset pointer.

Beispiele

Im folgenden Beispiel wird ein IntPtr Objekt instanziiert, das auf den Anfang eines Zehn-Element-Arrays verweist, 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 Zusatzvorgang in einem deaktivierten Kontext ausgeführt.

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

Gilt für

Siehe auch

Addition(IntPtr, Int32)

Freigeben über