Marshal.Copy 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從 Managed 陣列複製資料到 Unmanaged 記憶體指標,或從 Unmanaged 記憶體指標複製資料到 Managed 陣列。
多載
Copy(Single[], Int32, IntPtr, Int32) |
從一維、Managed 單精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(IntPtr, Single[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 單精確度浮點數陣列。 |
Copy(IntPtr, IntPtr[], Int32, Int32) |
從 Unmanaged 記憶體指標,將資料複製到 Managed IntPtr 陣列。 |
Copy(IntPtr, Int64[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 64 位元帶正負號的整數陣列。 |
Copy(IntPtr, Int32[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 32 位元帶正負號的整數陣列。 |
Copy(IntPtr, Int16[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 16 位元帶正負號的整數陣列。 |
Copy(IntPtr, Double[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到Managed 雙精確度浮點數陣列。 |
Copy(IntPtr[], Int32, IntPtr, Int32) |
從一維、Managed IntPtr 陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(IntPtr, Byte[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列。 |
Copy(Int64[], Int32, IntPtr, Int32) |
從一維、Managed 64 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(Int32[], Int32, IntPtr, Int32) |
從一維、Managed 32 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(Int16[], Int32, IntPtr, Int32) |
從一維、Managed 16 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(Double[], Int32, IntPtr, Int32) |
從一維、Managed 雙精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(Char[], Int32, IntPtr, Int32) |
從一維、Managed 字元陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(IntPtr, Char[], Int32, Int32) |
從 Unmanaged 記憶體指標將資料複製到 Managed 字元陣列。 |
Copy(Byte[], Int32, IntPtr, Int32) |
從一維、Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列將資料複製到 Unmanaged 記憶體指標。 |
Copy(Single[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 單精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <float> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (float[] source, int startIndex, IntPtr destination, int length);
public static void Copy (float[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : single[] * int * nativeint * int -> unit
static member Copy : single[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Single(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Single[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
source
、startIndex
、destination
或 length
為 null
。
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(IntPtr, Single[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 單精確度浮點數陣列。
public:
static void Copy(IntPtr source, cli::array <float> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, float[] destination, int startIndex, int length);
public static void Copy (IntPtr source, float[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * single[] * int * int -> unit
static member Copy : nativeint * single[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Single(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Single[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(IntPtr, IntPtr[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標,將資料複製到 Managed IntPtr 陣列。
public:
static void Copy(IntPtr source, cli::array <IntPtr> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, IntPtr[] destination, int startIndex, int length);
public static void Copy (IntPtr source, IntPtr[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * nativeint[] * int * int -> unit
static member Copy : nativeint * nativeint[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As IntPtr(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
-
IntPtr[]
nativeint[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 source
參數的 Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫 Marshal.Copy 方法。
適用於
Copy(IntPtr, Int64[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 64 位元帶正負號的整數陣列。
public:
static void Copy(IntPtr source, cli::array <long> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, long[] destination, int startIndex, int length);
public static void Copy (IntPtr source, long[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * int64[] * int * int -> unit
static member Copy : nativeint * int64[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Long(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Int64[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
Int64[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
Int64[] managedArray2 = new Int64[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Int64() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Int64
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(IntPtr, Int32[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 32 位元帶正負號的整數陣列。
public:
static void Copy(IntPtr source, cli::array <int> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, int[] destination, int startIndex, int length);
public static void Copy (IntPtr source, int[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * int[] * int * int -> unit
static member Copy : nativeint * int[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Integer(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Int32[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
int[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
int[] managedArray2 = new int[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Integer() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Integer
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(IntPtr, Int16[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 16 位元帶正負號的整數陣列。
public:
static void Copy(IntPtr source, cli::array <short> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, short[] destination, int startIndex, int length);
public static void Copy (IntPtr source, short[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * int16[] * int * int -> unit
static member Copy : nativeint * int16[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Short(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Int16[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
short[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
short[] managedArray2 = new short[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Short() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Short
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(IntPtr, Double[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到Managed 雙精確度浮點數陣列。
public:
static void Copy(IntPtr source, cli::array <double> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, double[] destination, int startIndex, int length);
public static void Copy (IntPtr source, double[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * double[] * int * int -> unit
static member Copy : nativeint * double[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Double(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Double[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
double[] managedArray = { 0.1, 0.2, 0.3, 0.4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
double[] managedArray2 = new double[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Double() = {0.1, 0.2, 0.3, 0.4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Double
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(IntPtr[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed IntPtr 陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <IntPtr> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr[] source, int startIndex, IntPtr destination, int length);
public static void Copy (IntPtr[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint[] * int * nativeint * int -> unit
static member Copy : nativeint[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As IntPtr(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
-
IntPtr[]
nativeint[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
備註
您可以使用這個方法,將一維 Managed IntPtr 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(IntPtr, Byte[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列。
public:
static void Copy(IntPtr source, cli::array <System::Byte> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, byte[] destination, int startIndex, int length);
public static void Copy (IntPtr source, byte[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * byte[] * int * int -> unit
static member Copy : nativeint * byte[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Byte(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Byte[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
byte[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
byte[] managedArray2 = new byte[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Byte() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Byte
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(Int64[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 64 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <long> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (long[] source, int startIndex, IntPtr destination, int length);
public static void Copy (long[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : int64[] * int * nativeint * int -> unit
static member Copy : int64[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Long(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Int64[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
source
、startIndex
、destination
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
Int64[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
Int64[] managedArray2 = new Int64[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Int64() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Int64
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(Int32[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 32 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <int> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (int[] source, int startIndex, IntPtr destination, int length);
public static void Copy (int[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : int[] * int * nativeint * int -> unit
static member Copy : int[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Integer(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Int32[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
int[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
int[] managedArray2 = new int[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Integer() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Integer
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(Int16[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 16 位元帶正負號的整數陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <short> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (short[] source, int startIndex, IntPtr destination, int length);
public static void Copy (short[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : int16[] * int * nativeint * int -> unit
static member Copy : int16[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Short(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Int16[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
source
、startIndex
、destination
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
short[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
short[] managedArray2 = new short[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Short() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Short
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(Double[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 雙精確度浮點數陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <double> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (double[] source, int startIndex, IntPtr destination, int length);
public static void Copy (double[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : double[] * int * nativeint * int -> unit
static member Copy : double[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Double(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Double[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
source
、startIndex
、destination
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
double[] managedArray = { 0.1, 0.2, 0.3, 0.4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
double[] managedArray2 = new double[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Double() = {0.1, 0.2, 0.3, 0.4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Double
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(Char[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 字元陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <char> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (char[] source, int startIndex, IntPtr destination, int length);
public static void Copy (char[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : char[] * int * nativeint * int -> unit
static member Copy : char[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Char(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Char[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
startIndex
、destination
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
// Remember that the actual size of System.Char in unmanaged memory is 2.
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
char[] managedArray = new char[1000];
managedArray[0] = 'a';
managedArray[1] = 'b';
managedArray[2] = 'c';
managedArray[3] = 'd';
managedArray[999] = 'Z';
// Initialize unmanaged memory to hold the array.
// int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length; // Incorrect
int size = Marshal.SystemDefaultCharSize * managedArray.Length; // Correct
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
char[] managedArray2 = new char[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}",
managedArray2[0], managedArray2[1], managedArray2[2], managedArray2[3],
managedArray2[999]);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
' Remember that the actual size of System.Char in unmanaged memory is 2.
Imports System.Runtime.InteropServices
Module Module1
Sub Main()
' Create a managed array.
Dim managedArray As Char() = New Char(999) {}
managedArray(0) = "a"c
managedArray(1) = "b"c
managedArray(2) = "c"c
managedArray(3) = "d"c
managedArray(999) = "Z"c
' Initialize unmanaged memory to hold the array.
' Dim size As Integer = Marshal.SizeOf(managedArray[0]) * managedArray.Length; ' Incorrect
Dim size As Integer = Marshal.SystemDefaultCharSize * managedArray.Length ' Correct
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2 As Char() = New Char(managedArray.Length - 1) {}
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}", managedArray2(0), managedArray2(1), managedArray2(2), managedArray2(3), managedArray2(999))
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。
適用於
Copy(IntPtr, Char[], Int32, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從 Unmanaged 記憶體指標將資料複製到 Managed 字元陣列。
public:
static void Copy(IntPtr source, cli::array <char> ^ destination, int startIndex, int length);
[System.Security.SecurityCritical]
public static void Copy (IntPtr source, char[] destination, int startIndex, int length);
public static void Copy (IntPtr source, char[] destination, int startIndex, int length);
[<System.Security.SecurityCritical>]
static member Copy : nativeint * char[] * int * int -> unit
static member Copy : nativeint * char[] * int * int -> unit
Public Shared Sub Copy (source As IntPtr, destination As Char(), startIndex As Integer, length As Integer)
參數
- source
-
IntPtr
nativeint
要複製的來源記憶體指標。
- destination
- Char[]
要複製到其中的陣列。
- startIndex
- Int32
複製應該在此處開始之目的地陣列中以零起始的索引。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
source
、destination
、startIndex
或 length
為 null
。
範例
下列範例會將陣列複製到 Unmanaged 記憶體,然後將 Unmanaged 陣組複製到 Managed 記憶體。
// Remember that the actual size of System.Char in unmanaged memory is 2.
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
char[] managedArray = new char[1000];
managedArray[0] = 'a';
managedArray[1] = 'b';
managedArray[2] = 'c';
managedArray[3] = 'd';
managedArray[999] = 'Z';
// Initialize unmanaged memory to hold the array.
// int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length; // Incorrect
int size = Marshal.SystemDefaultCharSize * managedArray.Length; // Correct
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
char[] managedArray2 = new char[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}",
managedArray2[0], managedArray2[1], managedArray2[2], managedArray2[3],
managedArray2[999]);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
' Remember that the actual size of System.Char in unmanaged memory is 2.
Imports System.Runtime.InteropServices
Module Module1
Sub Main()
' Create a managed array.
Dim managedArray As Char() = New Char(999) {}
managedArray(0) = "a"c
managedArray(1) = "b"c
managedArray(2) = "c"c
managedArray(3) = "d"c
managedArray(999) = "Z"c
' Initialize unmanaged memory to hold the array.
' Dim size As Integer = Marshal.SizeOf(managedArray[0]) * managedArray.Length; ' Incorrect
Dim size As Integer = Marshal.SystemDefaultCharSize * managedArray.Length ' Correct
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2 As Char() = New Char(managedArray.Length - 1) {}
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("Here is the roundtripped array: {0} {1} {2} {3} {4}", managedArray2(0), managedArray2(1), managedArray2(2), managedArray2(3), managedArray2(999))
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
Unmanaged、C 樣式數位不包含界限資訊,這可防止 startIndex
驗證 和 length
參數。 因此,對應至 參數的 source
Unmanaged 數據會填入 Managed 陣列,而不論其有用性為何。 您必須先使用適當的大小初始化 Managed 陣列,才能呼叫這個方法。
另請參閱
適用於
Copy(Byte[], Int32, IntPtr, Int32)
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
- 來源:
- Marshal.cs
從一維、Managed 8 位元不帶正負號的整數 (Unsigned Integer) 陣列將資料複製到 Unmanaged 記憶體指標。
public:
static void Copy(cli::array <System::Byte> ^ source, int startIndex, IntPtr destination, int length);
[System.Security.SecurityCritical]
public static void Copy (byte[] source, int startIndex, IntPtr destination, int length);
public static void Copy (byte[] source, int startIndex, IntPtr destination, int length);
[<System.Security.SecurityCritical>]
static member Copy : byte[] * int * nativeint * int -> unit
static member Copy : byte[] * int * nativeint * int -> unit
Public Shared Sub Copy (source As Byte(), startIndex As Integer, destination As IntPtr, length As Integer)
參數
- source
- Byte[]
要複製的一維陣列。
- startIndex
- Int32
複製應該在此處開始之來源陣列中以零起始的索引。
- destination
-
IntPtr
nativeint
要複製到的記憶體指標。
- length
- Int32
要複製的陣列元素數目。
- 屬性
例外狀況
startIndex
和 length
無效。
source
、startIndex
、destination
或 length
為 null
。
範例
下列範例會使用 多 Copy(Byte[], Int32, IntPtr, Int32) 載將數位複製到 Unmanaged 記憶體,然後使用 多載將 Unmanaged 陣列複製到 Managed 記憶體 Copy(IntPtr, Byte[], Int32, Int32) 。
using System;
using System.Runtime.InteropServices;
class Example
{
static void Main()
{
// Create a managed array.
byte[] managedArray = { 1, 2, 3, 4 };
// Initialize unmanaged memory to hold the array.
int size = Marshal.SizeOf(managedArray[0]) * managedArray.Length;
IntPtr pnt = Marshal.AllocHGlobal(size);
try
{
// Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length);
// Copy the unmanaged array back to another managed array.
byte[] managedArray2 = new byte[managedArray.Length];
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length);
Console.WriteLine("The array was copied to unmanaged memory and back.");
}
finally
{
// Free the unmanaged memory.
Marshal.FreeHGlobal(pnt);
}
}
}
Imports System.Runtime.InteropServices
Module Example
Sub Main()
' Create a managed array.
Dim managedArray As Byte() = {1, 2, 3, 4}
' Initialize unmanaged memory to hold the array.
Dim size As Integer = Marshal.SizeOf(managedArray(0)) * managedArray.Length
Dim pnt As IntPtr = Marshal.AllocHGlobal(size)
Try
' Copy the array to unmanaged memory.
Marshal.Copy(managedArray, 0, pnt, managedArray.Length)
' Copy the unmanaged array back to another managed array.
Dim managedArray2(managedArray.Length) As Byte
Marshal.Copy(pnt, managedArray2, 0, managedArray.Length)
Console.WriteLine("The array was copied to unmanaged memory and back.")
Finally
' Free the unmanaged memory.
Marshal.FreeHGlobal(pnt)
End Try
End Sub
End Module
備註
您可以使用這個方法,將一維 Managed 陣列的子集複製到 Unmanaged C 樣式陣列。