Marshal.Copy メソッド (Byte , Int32, IntPtr, Int32)
1 次元の 8 ビット符号なし整数のマネージ配列のデータをアンマネージ メモリ ポインタにコピーします。
Overloads Public Shared Sub Copy( _
ByVal source() As Byte, _ ByVal startIndex As Integer, _ ByVal destination As IntPtr, _ ByVal length As Integer _)
[C#]
public static void Copy(byte[] source,intstartIndex,IntPtrdestination,intlength);
[C++]
public: static void Copy(unsigned charsource __gc[],intstartIndex,IntPtrdestination,intlength);
[JScript]
public static function Copy(
source : Byte[],startIndex : int,destination : IntPtr,length : int);
パラメータ
- source
コピー元の 1 次元配列。 - startIndex
Copy を開始する配列内の 0 から始まるインデックス。 - destination
コピー先のメモリ ポインタ。 - length
コピーする配列要素の数。
例外
例外の種類 | 条件 |
---|---|
ArgumentOutOfRangeException | startIndex および length は有効ではありません。 |
解説
このメソッドを使用すると、1 次元の .NET ベースの配列のサブセットを C スタイルのアンマネージ配列にコピーできます。
メモ このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。
使用例
[Visual Basic, C#] 1 次元配列をアンマネージ メモリ ポインタにコピーする方法を次の例に示します。
Public Overloads Shared Sub Copy(source As Byte(), _
startIndex As Integer, destination As IntPtr, length As Integer)
[C#]
public static void Copy(byte[] source, int startIndex,
IntPtr destination, int length);
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
.NET Framework セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | Marshal.Copy オーバーロードの一覧