マネージドライブラリの使用

[アーティクル]
06/03/2023

共通言語ランタイムは、Microsoft .NET Frameworkの基盤です。共通言語ランタイムは、実行時にコードを管理し、メモリ管理、スレッド管理、リモート処理などのコアサービスを提供し、厳格なコード安全性を適用するエージェントと考えることができます。実際、コード管理の概念は、共通言語ランタイムの基本的な原則です。共通言語ランタイムを対象とするコードは、マネージドコードと呼ばれます。共通言語ランタイムを対象としないコードは、ネイティブコードと呼ばれます。

フレームワーククラスライブラリは、従来のコマンドラインまたはグラフィカルユーザーインターフェイス (GUI) アプリケーションから、ASP.NET および Web サービスによって提供される最新のイノベーションに基づくアプリケーションまで、アプリケーションの開発に使用できる、再利用可能なクラスの包括的なオブジェクト指向コレクションです。

Tablet PC Managed Library には、Framework を拡張して、タブレット PC での手書きの入力と出力、および他のコンピューターとのデータ交換をサポートする一連のマネージドオブジェクトが含まれています。

例外

Tablet PC API のマネージドライブラリオブジェクトは、COM ライブラリの実装をラップします。基になる COM ライブラリオブジェクトまたはコントロールがエラーを返すと、マネージド API のは、内部 COM 例外の詳細を提供する Marshal.ThrowExceptionForHR 例外をスローします。返される可能性のあるエラーの詳細については、「COM ライブラリリファレンス」の HRESULT 値を参照してください。

オブジェクトの比較

Tablet PC Platform Managed ライブラリ内のすべてのオブジェクトについて、 Equals は同じ 2 つのオブジェクトを正しく比較するためにオーバーライドされません。マネージドアプリケーションプログラミングインターフェイス (API) では、 Equals 関数または equals (==) 演算子を使用したオブジェクトの等価比較はサポートされていません。

イベントの操作

マネージドオブジェクトのイベントハンドラー内のコードが例外をスローした場合、例外はユーザーに配信されません。例外が確実に配信されるようにするには、マネージドイベントのイベントハンドラーで try-catch ブロックを使用します。

フォームの管理

Form クラスとその基底クラスでは、ファイナライザーは定義されません。フォームでリソースをクリーンするには、Dispose を呼び出すファイナライザー (~を使用する C# デストラクターなど) を提供するサブクラスを記述します。クリーンアップを行うには、ファイナライザーによって Dispose がオーバーライドされ、基底クラス Dispose が呼び出されます。ブール値パラメーターが FALSE の場合、Dispose メソッドの Finalize メソッドを必要とする他のオブジェクトは参照しないでください。これらのオブジェクトは既に最終処理されている可能性があるためです。リソースの解放の詳細については、「 Finalize Methods and デストラクター」を参照してください。

フォームと RecognizerContext

RecognizerContext イベントは、フォームが存在するスレッドとは異なるスレッドで実行されます。 Windows フォーム内のコントロールは特定のスレッドにバインドされ、スレッドセーフではありません。したがって、コントロールの呼び出しメソッドのいずれかを使用して、適切なスレッドへの呼び出しをマーシャリングする必要があります。コントロールの 4 つのメソッドは、スレッドセーフです。 Invoke、 BeginInvoke、 EndInvoke、 CreateGraphics の各メソッドです。他のすべてのメソッド呼び出しでは、別のスレッドからを呼び出すときに、これらの呼び出しメソッドのいずれかを使用します。これらのメソッドの使用方法の詳細については、「スレッドからのコントロールの操作」を参照してください。

イベントの待機中

タブレット PC 環境はマルチスレッドです。他の待機メソッドの代わりに CoWaitForMultipleHandles 関数を使用して、アプリケーションがイベントを待機している間にコンポーネントオブジェクトモデル (COM) 呼び出しを再入力してマルチスレッドアパートメント (MTA) に入れるようにします。

インクストロークコレクションの使用

Ink オブジェクトから取得された Strokes コレクションのインスタンスはガベージコレクションされません。メモリリークを回避するために、これらのコレクションのいずれかを操作するときは、次に示すように "using" ステートメントを使用します。

using (Strokes strokes = myInk.Strokes)
{
    int i = strokes.Count;
}

マネージドオブジェクトとコントロールの破棄

メモリリークを回避するには、オブジェクトまたはコントロールがスコープ外になる前に、イベントハンドラーがアタッチされている Tablet PC オブジェクトまたはコントロールで Dispose メソッドを明示的に呼び出す必要があります。

アプリケーションのパフォーマンスを向上させるには、次のオブジェクト、コントロール、およびコレクションが不要になったら、手動で破棄します。

次の C# の例では、 Dispose メソッドを使用するいくつかのシナリオを示します。

// A field for a Divider object
private Microsoft.Ink.Divider theDivider;

// A method that creates a Divider object
public void CreateDivider()
{
    // Make sure any previous Divider object was disposed of.
    if (null != theDivider)
    {
        theDivider.Dispose();
        theDivider = null;
    }
    // Create the Divider object.
    theDivider = new Microsoft.Ink.Divider();

    // The remainder of the method
}

// A method that disposes of the Divider object
public void DisposeDivider()
{
    // The remainder of the method

    // Dispose of the Divider object.
    if (null != theDivider)
    {
        theDivider.Dispose();
        theDivider = null;
    }
}

// A method that uses a local PenInputPanel object.
public void UsePenInputPanel()
{
    // Create the PenInputPanel object.
    Microsoft.Ink.PenInputPanel thePenInputPanel =
        new Microsoft.Ink.PenInputPanel();

    // The remainder of the method

    // Dispose of the PenInputPanel object before exiting.
    thePenInputPanel.Dispose();
    thePenInputPanel = null;
}

Share via

マネージドライブラリの使用

例外

オブジェクトの比較

最新のMicrosoft.Ink.dllへのバインド

イベントの操作

フォームの管理

フォームと RecognizerContext

イベントの待機中

インクストロークコレクションの使用

マネージドオブジェクトとコントロールの破棄

フィードバック

フィードバック

その他のリソース

Share via

マネージド ライブラリの使用

例外

オブジェクトの比較

最新のMicrosoft.Ink.dllへのバインド

イベントの操作

フォームの管理

フォームと RecognizerContext

イベントの待機中

インク ストローク コレクションの使用

マネージド オブジェクトとコントロールの破棄

フィードバック

フィードバック

その他のリソース

マネージドライブラリの使用

インクストロークコレクションの使用

マネージドオブジェクトとコントロールの破棄