UIntPtr.Add(UIntPtr, Int32) Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Fügt einen Offset zu einer nicht signierten ganzen Zahl hinzu.

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

Parameter

pointer
UIntPtr

unativeint

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

offset
Int32

Der hinzuzufügende Offset.

Gibt zurück

UIntPtr

unativeint

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

Beispiele

Im folgenden Beispiel wird ein UIntPtr 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;

public class Example
{
   public static void Main()
   {
      int[] arr = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
      UIntPtr ptr = (UIntPtr) arr[0];
      for (int ctr = 0; ctr < arr.Length; ctr++)
      {
         UIntPtr newPtr = UIntPtr.Add(ptr, ctr);
         Console.Write("{0}   ", newPtr);
      }      
   }
}
// The example displays the following output:
//       1   2   3   4   5   6   7   8   9   10

open System

let arr = [| 1; 2; 3; 4; 5; 6; 7; 8; 9; 10 |]
let ptr = UIntPtr(uint arr[0])
for i = 0 to arr.Length - 1 do
    let newPtr = UIntPtr.Add(ptr, i)
    printf $"{newPtr}   "
// The example displays the following output:
//       1   2   3   4   5   6   7   8   9   10

Module Example
   Public Sub Main()
      Dim arr() As Integer = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
      Dim ptr As UIntPtr = CType(arr(0), UIntPtr)
      For ctr As Integer= 0 To arr.Length - 1
         Dim newPtr As UIntPtr = UIntPtr.Add(ptr, ctr)
         Console.Write("{0}   ", newPtr)
      Next
   End Sub
End Module
' The example displays the following output:
'       1   2   3   4   5   6   7   8   9   10

Hinweise

Die Add Methode löst keine Ausnahme aus, wenn das Ergebnis zu groß ist, um als nicht 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