Overlapped

.NET Framework クラス ライブラリ リファレンス

Overlapped クラス

Overlapped インスタンスからの情報を NativeOverlapped 構造体に転送するためのメソッドを含む、Win32 OVERLAPPED 構造体のマネージ表現を提供します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Class Overlapped

Visual Basic (使用法)

Dim instance As Overlapped

C#

[ComVisibleAttribute(true)] 
public class Overlapped

C++

[ComVisibleAttribute(true)] 
public ref class Overlapped

J#

/** @attribute ComVisibleAttribute(true) */ 
public class Overlapped

JScript

ComVisibleAttribute(true) 
public class Overlapped

解説

Pack メソッドおよび UnsafePack メソッドは、Overlapped オブジェクトからの情報を、非同期ファイル I/O 用の Win32 API 関数に渡すことができる NativeOverlapped 構造体に転送します。Unpack メソッドは、NativeOverlapped 構造体からの情報を Overlapped クラスのインスタンスに転送します。

Overlapped オブジェクトのプロパティを変更すると、このオブジェクトに関連付けられている NativeOverlapped 構造体が影響を受けます。その逆も同様です。

継承階層

System.Object
  System.Threading.Overlapped

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Overlapped メンバ
System.Threading 名前空間

Overlapped コンストラクタ ()

Overlapped クラスの新しい空のインスタンスを初期化します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New Overlapped

C#

public Overlapped ()

C++

public:
Overlapped ()

J#

public Overlapped ()

JScript

public function Overlapped ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Overlapped クラス
Overlapped メンバ
System.Threading 名前空間

Overlapped コンストラクタ (Int32, Int32, IntPtr, IAsyncResult)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

ファイル位置、I/O 操作が完了したときに通知されるイベントのハンドル、および操作結果を返すためのインターフェイスを指定して、Overlapped クラスの新しいインスタンスを初期化します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    offsetLo As Integer, _
    offsetHi As Integer, _
    hEvent As IntPtr, _
    ar As IAsyncResult _
)

Visual Basic (使用法)

Dim offsetLo As Integer
Dim offsetHi As Integer
Dim hEvent As IntPtr
Dim ar As IAsyncResult

Dim instance As New Overlapped(offsetLo,
 offsetHi, hEvent, ar)

C#

public Overlapped (
    int offsetLo,
    int offsetHi,
    IntPtr hEvent,
    IAsyncResult ar
)

C++

public:
Overlapped (
    int offsetLo, 
    int offsetHi, 
    IntPtr hEvent, 
    IAsyncResult^ ar
)

J#

public Overlapped (
    int offsetLo, 
    int offsetHi, 
    IntPtr hEvent, 
    IAsyncResult ar
)

JScript

public function Overlapped (
    offsetLo : int, 
    offsetHi : int, 
    hEvent : IntPtr, 
    ar : IAsyncResult
)

パラメータ

offsetLo

転送を開始するファイル位置の下位ワード。

offsetHi

転送を開始するファイル位置の上位ワード。

hEvent

I/O 操作が完了したときに通知されるイベントのハンドル。

ar

IAsyncResult インターフェイスを実装し、I/O 操作に関するステータス情報を提供するオブジェクト。

解説

WaitHandle クラスから派生するマネージ同期オブジェクトのハンドルを取得するには、WaitHandle.SafeWaitHandle プロパティを使用して SafeWaitHandle オブジェクトを取得してから、DangerousGetHandle メソッドを呼び出します。

IAsyncResult の実装により、I/O 操作に関するステータス情報が提供されます。この情報を ar パラメータのコンストラクタに渡し、後で AsyncResult プロパティを使用して取得します。Pack メソッドまたは UnsafePack メソッドにコールバック メソッドが指定されている場合、コールバックは受け取った NativeOverlapped 構造体を展開することによって IAsyncResult を取得できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Overlapped クラス
Overlapped メンバ
System.Threading 名前空間

Overlapped コンストラクタ (Int32, Int32, Int32, IAsyncResult)

メモ : このコンストラクタは、互換性のために残されています。 旧式でない代替が必要な場合は、Overlapped(Int32,Int32,IntPtr,IAsyncResult) を使用してください。

ファイル位置、I/O 操作が完了したときに通知されるイベントの 32 ビット整数ハンドル、および操作結果を返すためのインターフェイスを指定して、Overlapped クラスの新しいインスタンスを初期化します。

名前空間: System.Threading
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ObsoleteAttribute("This constructor is not 64-bit compatible.
  Use the constructor that takes an IntPtr for the event handle.  http://go.microsoft.com/fwlink/?linkid=14202")>
 _
Public Sub New ( _
    offsetLo As Integer, _
    offsetHi As Integer, _
    hEvent As Integer, _
    ar As IAsyncResult _
)

Visual Basic (使用法)

Dim offsetLo As Integer
Dim offsetHi As Integer
Dim hEvent As Integer
Dim ar As IAsyncResult

Dim instance As New Overlapped(offsetLo,
 offsetHi, hEvent, ar)

C#

[ObsoleteAttribute("This constructor is not 64-bit compatible.  Use the constructor
 that takes an IntPtr for the event handle.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public Overlapped (
    int offsetLo,
    int offsetHi,
    int hEvent,
    IAsyncResult ar
)

C++

[ObsoleteAttribute(L"This constructor is not 64-bit compatible.  Use the constructor
 that takes an IntPtr for the event handle.  http://go.microsoft.com/fwlink/?linkid=14202")]
 
public:
Overlapped (
    int offsetLo, 
    int offsetHi, 
    int hEvent, 
    IAsyncResult^ ar
)

J#

/** @attribute ObsoleteAttribute("This constructor is not 64-bit compatible.
  Use the constructor that takes an IntPtr for the event handle.
  http://go.microsoft.com/fwlink/?linkid=14202") */ 
public Overlapped (
    int offsetLo, 
    int offsetHi, 
    int hEvent, 
    IAsyncResult ar
)

JScript

ObsoleteAttribute("This constructor is not 64-bit compatible.  Use the constructor
 that takes an IntPtr for the event handle.  http://go.microsoft.com/fwlink/?linkid=14202")
 
public function Overlapped (
    offsetLo : int, 
    offsetHi : int, 
    hEvent : int, 
    ar : IAsyncResult
)

パラメータ

offsetLo

転送を開始するファイル位置の下位ワード。

offsetHi

転送を開始するファイル位置の上位ワード。

hEvent

I/O 操作が完了したときに通知されるイベントのハンドル。

ar

IAsyncResult インターフェイスを実装し、I/O 操作に関するステータス情報を提供するオブジェクト。

解説

WaitHandle クラスから派生するマネージ同期イベンのハンドルを取得するには、WaitHandle.Handle プロパティを使用します。

IAsyncResult の実装により、I/O 操作に関するステータス情報が提供されます。この情報を ar パラメータのコンストラクタに渡し、後で AsyncResult プロパティを使用して取得します。Pack メソッドまたは UnsafePack メソッドにコールバック メソッドが指定されている場合、コールバックは受け取った NativeOverlapped 構造体を展開することによって IAsyncResult を取得できます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 1.0、1.1
2.0 では、互換性のために残されています (コンパイル時に警告)

参照

関連項目
Overlapped クラス
Overlapped メンバ
System.Threading 名前空間

Overlapped コンストラクタ

Overlapped クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
Overlapped ()	Overlapped クラスの新しい空のインスタンスを初期化します。
Overlapped (Int32, Int32, Int32, IAsyncResult)	ファイル位置、I/O 操作が完了したときに通知されるイベントの 32 ビット整数ハンドル、および操作結果を返すためのインターフェイスを指定して、Overlapped クラスの新しいインスタンスを初期化します。
Overlapped (Int32, Int32, IntPtr, IAsyncResult)	ファイル位置、I/O 操作が完了したときに通知されるイベントのハンドル、および操作結果を返すためのインターフェイスを指定して、Overlapped クラスの新しいインスタンスを初期化します。

参照

関連項目

Overlapped クラス
Overlapped メンバ
System.Threading 名前空間

Overlapped プロパティ

パブリック プロパティ

	名前	説明
	AsyncResult	I/O 操作に関するステータス情報を提供するオブジェクトを取得または設定します。
	EventHandle	I/O 操作が完了したときに通知される同期イベントの 32 ビット整数ハンドルを取得または設定します。
	EventHandleIntPtr	I/O 操作が完了したときに通知される同期イベントのハンドルを取得または設定します。
	OffsetHigh	転送を開始するファイル位置の上位ワードを取得または設定します。ファイル位置は、ファイルの開始位置からのバイト オフセットです。
	OffsetLow	転送を開始するファイル位置の下位ワードを取得または設定します。ファイル位置は、ファイルの開始位置からのバイト オフセットです。

参照

関連項目

Overlapped クラス
System.Threading 名前空間

Overlapped メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Free	Pack メソッドによって割り当てられたネイティブなオーバーラップ構造体に関連付けられているアンマネージ メモリを解放します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Pack	オーバーロードされます。 現在のインスタンスを NativeOverlapped 構造体にパックします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Unpack	指定したアンマネージ NativeOverlapped 構造体をマネージ Overlapped オブジェクトに展開します。
	UnsafePack	オーバーロードされます。 現在のインスタンスを NativeOverlapped 構造体にパックします。コール スタックは反映しません。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

Overlapped クラス
System.Threading 名前空間

Overlapped メンバ

Overlapped インスタンスからの情報を NativeOverlapped 構造体に転送するためのメソッドを含む、Win32 OVERLAPPED 構造体のマネージ表現を提供します。

Overlapped データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	Overlapped	オーバーロードされます。 Overlapped クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	AsyncResult	I/O 操作に関するステータス情報を提供するオブジェクトを取得または設定します。
	EventHandle	I/O 操作が完了したときに通知される同期イベントの 32 ビット整数ハンドルを取得または設定します。
	EventHandleIntPtr	I/O 操作が完了したときに通知される同期イベントのハンドルを取得または設定します。
	OffsetHigh	転送を開始するファイル位置の上位ワードを取得または設定します。ファイル位置は、ファイルの開始位置からのバイト オフセットです。
	OffsetLow	転送を開始するファイル位置の下位ワードを取得または設定します。ファイル位置は、ファイルの開始位置からのバイト オフセットです。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Free	Pack メソッドによって割り当てられたネイティブなオーバーラップ構造体に関連付けられているアンマネージ メモリを解放します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Pack	オーバーロードされます。 現在のインスタンスを NativeOverlapped 構造体にパックします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Unpack	指定したアンマネージ NativeOverlapped 構造体をマネージ Overlapped オブジェクトに展開します。
	UnsafePack	オーバーロードされます。 現在のインスタンスを NativeOverlapped 構造体にパックします。コール スタックは反映しません。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

Overlapped クラス
System.Threading 名前空間