方法 : ログファイルを作成します。

[アーティクル]
10/29/2009

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。空白のトピックは、プレースホルダーとして挿入されています。]

プログラムの読み込みとネットワークの相互運用性、に関する診断情報を含むログファイル作成できます。ログを有効に、レジストリキーを設定できます。最初に、一般的なログを有効にするには、レジストリキー設定し、目的のログコンポーネントおよびオプションのレジストリキーを設定します。

以下の方法を使用してレジストリキーを設定することができます。

Visual Studio 中には、リモートレジストリエディターを使用します。
.NET Compact Framework 2.0 Service Pack 1 でリモートパフォーマンスモニターでログオプションを使用します。リモートパフォーマンスモニターについては、方法 : ファイル名を指定して実行時にパフォーマンスの監視を参照してください。
.NET Compact Framework 3.5 で、ログツールを有効またはログを無効にする単純なグラフィカルユーザーインターフェイスを提供する NetCFLogging.exe 使用できます。 .NET Compact Framework の電源社には、このツールが含まれます。詳細については、Power Toy .NET Compact Framework を参照してください。
Registry と、 RegistryKey とそれ以降のバージョンでサポートされている .NET Compact Framework Version 2.0 クラスを使用します。

次の表は、ログファイル。

ログコンポーネント	ログファイルの内容
相互運用	COM 相互運用機能呼び出しをログします。プラットフォームに関する情報を提供呼び出しおよびマーシャリングします。
エラー	すべての未処理とネイティブの例外をログします。エラーは、ログファイルを OutputDebugString 記録されます。ログファイルは、現在のパスにある各アセンブリに対して作成され、現在のセッションに適用されます。未処理またはネイティブ例外が最初に見つかった後、は、ログファイルを上書きします。
ローダー	プログラムの読み込みに関する情報を記録します。持つ情報は次のファイルヘッダーのとおりです。アプリケーションの名前です。 Windows Embedded CE による) などのプロセス ID。ローカルの日付と時刻、ログファイルが作成されたです。形式がグローバルまたはカルチャに固有ではありません。 .NET Compact Framework バージョン、2.0.5021.00 など) です。プラットフォームに関連したなどの情報 Windows Embedded CE v5.0.1400 (CEPC) WinCE5x86 デバッグ開発 i386 IJITv2。ファイルには、次の情報提供されています。強制変換の状態 (互換モード)。信頼レベルは読み込まれているモジュールに割り当てられました。メソッドの解決に失敗しました。型解決に失敗しました。検索またはアセンブリまたはモジュールの読み込みに失敗しました。アセンブリの読み込みに成功します。無効なメタデータのバージョン。プラットフォームの検索に失敗した DLL を呼び出します。プラットフォーム内の関数の検索に失敗した DLL を呼び出します。ポリシーファイルまたはその休暇の実際の名前。ポリシーファイルの処理中に重大なエラーです。マネージアセンブリのポリシーベースのリダイレクトします。グローバルアセンブリキャッシュに関する情報を追加することができるも。
ネットワーキング	ログのネットワークトラフィック。ネットワークのログファイルはバイナリと、.NET Compact Framework ログビューアー、Logviewer.exe せずにアクセスできません。 .NET Compact Framework 3.5 以降では、ログビューアーに、電源社の .NET Compact Framework の含まれます。詳細については、Power Toy .NET Compact Framework を参照してください。 Windows ソケット層のネットワークログオンが発生したため、ログファイルがネットワークのパケット情報のみ含まれています。これには暗号化されていない場合は、機密データがあります、ネットワーク経由で送信されるデータが含まれます。
ファイナライザー	ガベージコレクターによって破棄されますが前に破棄されなかったオブジェクトのクラス名前を記録します。このログは .NET Compact Framework 3.5 とそれ以降のバージョンではサポートします。オブジェクト名は名前が、共通言語ランタイム (CLR) できないために、ログに含まれていません。ただし、undisposed オブジェクトのクラス名これらのオブジェクトを識別役立てることができます。 undisposed オブジェクトはアプリケーションでパフォーマンスの問題を作成できます。メモ場合によっては、アプリケーションコードの代わりに、.NET Compact Framework ファイナライザーを呼び出します。このファイルには、次の情報が含まれます。示す、ファイナライザーがガベージコレクターは、上で実行時のタイムスタンプは、オブジェクト。終了したオブジェクトのクラス。
トレース	ログは Windows 通信基盤 (WCF) の例外をコードです。デスクトップで .NET Framework は、次の 3 つの種類のログサポートします。トレース、メッセージング、およびイベントのログ出力します。 .NET Compact Framework で WCF はトレースのみをコードの例外を追跡するログサポートしますが警告とエラーメッセージは記録されません。このログは .NET Compact Framework 3.5 とそれ以降のバージョンではサポートします。

既定では、ログファイルはアプリケーション中、診断がそのアプリケーションを含むディレクトリに書き込まれます。ただし、指定できます、パスとその他のオプションとレジストリキーとおり。

代替パスが、ログファイルを記述してください。これにはセキュリティで保護されたレジストリへの特権のアクセスが必要です。
ログファイル名に、アプリケーション名を含めます。
ログファイル名にプロセス ID を含める

「相互運用機能」、「エラー」、「ローダー」、「ネットワーク」、「ファイナライザー」、またはトレース"コンポーネントのを指定できますを次の要素は、ログファイル名を持ちます。

netcf_ アプリケーション名_コンポーネント_プロセス.log

アプリケーション名とプロセス ID は省略可能なレジストリ設定に基づきます。

たとえば、ローダーログファイルという名前の MyApp.exe アプリケーションを可能性がありますというは名前とおり。

netcf_MyApp_Loader_2066923010.log

相互運用機能などのログファイルとローダーログファイルを確認する方法については、ログファイルの情報を参照してください。

ログの記録を有効にするには

次の有効] にキー値を 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Enabled

このキーの値は 6 種類のログを有効に設定する必要があります。相互運用機能、ローダー、エラー、ネットワーク、ファイナライザー、およびトレースします。既定では、ログ下のサブキーが存在しないことを確認します。

この値を 0 (ゼロ) に設定をすべてのログをオフすることができます。

(省略可能)、ログファイルのパスを指定

ログファイルの場所を表す文字列に、次のパスキーの値を設定します。

HKLM\Security\.NETCompactFramework\Diagnostics\Logging\Path

このキーは、セキュリティで保護されたレジストリに書き込むことができるアプリケーションによってのみアクセスできます。パスが指定しない場合、ログファイルは、アプリケーションを含むディレクトリに書き込まれます。

名前 (省略可能) に、アプリケーションを含める

1、次の UseApp キーの値を設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\UseApp

このキーは、複数のアプリケーションを実行してアプリケーションごとに個別のログファイルを取得する場合に役立ちます。 2 つのアプリケーションを同じディレクトリにログファイルを作成している場合、古いログファイルは常にによって上書きされます新しいログファイルの 2 つ目のアプリケーションの実行時。 UseApp キーは、ログファイルのディフェレンシエータとして使用できます。

名前 (省略可能) に、プロセス ID を含める

1、次の UsePid キーの値を設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\UsePid

このキーは 1 つのアプリケーションを複数回実行して別のログの各インスタンスを作成する場合に役立ちます。この設定では、アプリケーションの各インスタンスを別の名前で新しいログファイルを作成できるようにログファイル名にプロセス ID は、追加されます。

(省略可能) が発生するイベントを記録

次のフラッシュのキー値を 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Flush

この値と共通言語ランタイム (CLR) のバッファーのと、バッファーがいっぱいのときに書き込みではなく行われた、ログファイルにログのイベントを書き込む。この設定は悪影響を及ぼす、アプリケーションのパフォーマンスに影響し、アプリケーションのタイミングを少し変更可能性があります。ただし、できますアプリケーションの障害やその他のエラーに関連する問題の診断に役立ちます、エラーが発生した最後のいくつかイベントを表示先可能性があります。このキーが存在またはしない設定ではない場合、バッファーがいっぱいになるまでデータは、ログファイルに書き込まれません。

相互運用ログ

相互運用ログを有効にするには

次の有効] にキー値を 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Interop\Enabled

エラーログの記録

エラーログを有効にするには

次の有効値は 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Error\Enabled

ローダーログ

ローダーログを有効にするには

ログ、ローダーを有効にする 1 に、次の有効値を設定またはログ、ローダーとグローバルアセンブリキャッシュを有効にする 2 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Loader\Enabled

ネットワークログの記録

ネットワークログを有効にするには

次の有効値は 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Network\Enabled

ネットワークのログファイルはバイナリと、.NET Compact Framework ログビューアー、Logviewer.exe、バイナリ形式からログ人間が判読できる形式に変換することがなくを読み取れませんでした。 .NET Compact Framework 3.5 以降では、ログビューアーに、電源社の .NET Compact Framework の含まれます。のページの .NET Compact Framework ダウンロードからこのツールをダウンロードできます。

ファイナライザーのログ

ファイナライザーのログを有効に

次の有効値は 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Finalizer\Enabled

トレースログの記録

WCF のトレースログの記録を有効にするには

次の有効値は 1 に設定します。

HKLM\Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\WCF\Enabled

使用例

レジストリ値を設定するアプリケーションを記述できます。このセクションの例は、次の必要なレジストリのタスクを処理するメソッドが。

EnableLogging メソッドは、一般的なログを有効し、パラメーターを指定するには、ログファイルの代替のパスを指定するかどうか、アプリケーションの名前とプロセスの ID は、ログファイル名およびが発生したときにイベントが記録されるかどうかを指定する追加されます。
SetInteropLogging SetLoaderLogging、および SetNetworkLogging メソッドを設定、対応する有効] にキーの値を 1 にそのコンポーネントのログが有効にするようにします。
DisableLogging メソッドは、すべてのログを無効にします。
WriteLoggingSettings メソッド再帰的にログサブキーの下に、キーをチェックし、ログファイルに名前と値を書き込みます。ログファイル logsettings.txt という名前れ、このサンプルアプリケーションを含むディレクトリにあります。

                        ' This method enables general logging. It contains parameters
                        ' to specify a path, and Boolean values of true to include
                        ' the application name, process ID, and events in the log.
                        Private
                        Sub EnableLogging(ByVal useApp AsBoolean, ByVal usePid AsBoolean, ByVal useFlush AsBoolean) 
    ' Specify values for setting the registry.Dim userRoot AsString = "HKEY_LOCAL_MACHINE"Dim subkey AsString = "SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging"Dim keyName AsString = userRoot + "\" + subkey

    ' Set the Enabled registry value.
    Registry.SetValue(keyName, "Enabled", 1)

    If useApp = TrueThen
        Registry.SetValue(keyName, "UseApp", 1)
    Else
        Registry.SetValue(keyName, "UseApp", 0)
    EndIfIf usePid = TrueThen
        Registry.SetValue(keyName, "UsePid", 1)
    Else
        Registry.SetValue(keyName, "UsePid", 0)
    EndIfIf useFlush = TrueThen
        Registry.SetValue(keyName, "UseFlush", 1)
    Else
        Registry.SetValue(keyName, "UseFlush", 0)
    EndIfEndSub
' This method sets the Enabled key value to 1' so that logging for Interoperability is enabled.PrivateSub SetInteropLogging(ByVal logOn AsBoolean) 
    ' Specify values for setting the registry.Dim userRoot AsString = "HKEY_LOCAL_MACHINE"Dim subkey AsString = "Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Interop"Dim keyName AsString = userRoot + "\" + subkey

    Dim logSet AsIntegerIf logOn = TrueThen
        logSet = 1
    Else
        logSet = 0
    EndIf    ' Set the registry value.Try
        Registry.SetValue(keyName, "Enabled", logSet)
        If logOn = TrueThen
            MessageBox.Show("Interop Logging On")
        Else
            MessageBox.Show("Interop Logging Off")
        EndIfCatch ex As System.Exception
        MessageBox.Show(ex.Message)
    EndTryEndSub

' This method sets the Enabled key value to 1' so that logging for class loading is enabled.PrivateSub SetLoaderLogging(ByVal logOn AsBoolean) 
    ' Specify values for setting the registry.Dim userRoot AsString = "HKEY_LOCAL_MACHINE"Dim subkey AsString = "Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Loader"Dim keyName AsString = userRoot + "\" + subkey

    Dim logSet AsIntegerIf logOn = TrueThen
        logSet = 1
    Else
        logSet = 0
    EndIf    ' Set the registry value.Try
        Registry.SetValue(keyName, "Enabled", logSet)
        If logOn = TrueThen
            MessageBox.Show("Loader Logging On")
        Else
            MessageBox.Show("Loader Loggin Off")
        EndIfCatch ex As System.Exception
        MessageBox.Show(ex.Message)
    EndTryEndSub

' This method sets the Enabled key value to 1,' so that logging for networking is enabled.PrivateSub SetNetworkLogging(ByVal logOn AsBoolean) 
    ' Specify values for setting the registry.Dim userRoot AsString = "HKEY_LOCAL_MACHINE"Dim subkey AsString = "Software\Microsoft\.NETCompactFramework\Diagnostics\Logging\Network"Dim keyName AsString = userRoot + "\" + subkey

    Dim logSet AsIntegerIf logOn = TrueThen
        logSet = 1
    Else
        logSet = 0
    EndIf    ' Set the registry value.Try
        Registry.SetValue(keyName, "Enabled", logSet)
        If logOn = TrueThen
            MessageBox.Show("Networking Logging On")
        Else
            MessageBox.Show("Networking Logging Off")
        EndIfCatch ex As System.Exception
        MessageBox.Show(ex.Message)
    EndTryEndSub

' This method disables all logging.PrivateSub DisableLogging() 
    ' Specify values for setting the registry.Dim userRoot AsString = "HKEY_LOCAL_MACHINE"Dim subkey AsString = "SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging"Dim keyName AsString = userRoot + "\" + subkey

    ' Set the Enabled registry value.
    Registry.SetValue(keyName, "Enabled", 0)
    MessageBox.Show("Logging Disabled")

EndSub

' This method recursively examines the keys' under the Logging subkey and writes their' key names and values to a log file. It saves' the information in "logsettings.txt", located' in the directory that contains this example' application.PrivateSub WriteLoggingSettings() 
    Dim sw AsNew StreamWriter("logsettings.txt", False)
    sw.WriteLine("General Logging Settings:")
    Dim rkLogging As RegistryKey = Registry.LocalMachine.OpenSubKey("SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging")
    Dim valNames AsString() = rkLogging.GetValueNames()
    Dim x AsIntegerFor x = 0 To valNames.Length
        sw.WriteLine(valNames(x).ToString() + ": " + rkLogging.GetValue(valNames(x)).ToString())
    Next x

    sw.WriteLine()
    sw.WriteLine("Interop Logging:")
    Dim rkInterop As RegistryKey = Registry.LocalMachine.OpenSubKey("SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging\Interop")
    Dim interopNames AsString() = rkInterop.GetValueNames()

    For x = 0 To interopNames.Length
        sw.WriteLine(interopNames(x).ToString() + ": " + rkInterop.GetValue(interopNames(x)).ToString())
    Next x

    sw.WriteLine()
    sw.WriteLine("Loader Logging:")
    Dim rkLoader As RegistryKey = Registry.LocalMachine.OpenSubKey("SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging\Loader")
    Dim loaderNames AsString() = rkLoader.GetValueNames()
    For x = 0 To loaderNames.Length
        sw.WriteLine(loaderNames(x).ToString() + ": " + rkLoader.GetValue(loaderNames(x)).ToString())
    Next x

    sw.WriteLine()
    sw.WriteLine("Networking Logging:")
    Dim rkNetworking As RegistryKey = Registry.LocalMachine.OpenSubKey("SOFTWARE\Microsoft\.NETCompactFramework\Diagnostics\Logging\Network")
    Dim netNames AsString() = rkNetworking.GetValueNames()
    For x = 0 To netNames.Length
        sw.WriteLine(netNames(x).ToString() + ": " + rkNetworking.GetValue(netNames(x)).ToString())
    Next x
    sw.Close()
EndSub

                        // This method enables general logging. It contains parameters
                        // to specify a path, and Boolean values of true to include
                        // the application name, process ID, and events in the log.
                        private
                        void EnableLogging(bool useApp, bool usePid, bool useFlush)
{
    // Specify values for setting the registry.string userRoot = "HKEY_LOCAL_MACHINE";
    string subkey = "SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging";
    string keyName = userRoot + "\\" + subkey;

    // Set the Enabled registry value.
    Registry.SetValue(keyName, "Enabled", 1);

    if (useApp == true)
        Registry.SetValue(keyName, "UseApp", 1);
    else
        Registry.SetValue(keyName, "UseApp", 0);

    if (usePid == true)
        Registry.SetValue(keyName, "UsePid", 1);
    else
        Registry.SetValue(keyName, "UsePid", 0);

    if (useFlush == true)
        Registry.SetValue(keyName, "UseFlush", 1);
    else
        Registry.SetValue(keyName, "UseFlush", 0);
}

// This method sets the Enabled key value to 1// so that logging for Interoperability is enabled.privatevoid SetInteropLogging(bool logOn)
{
    // Specify values for setting the registry.string userRoot = "HKEY_LOCAL_MACHINE";
    string subkey = "Software\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Interop";
    string keyName = userRoot + "\\" + subkey;

    int logSet;
    if(logOn == true)
      logSet = 1;
    else
      logSet = 0;

    // Set the registry value.try
    {
     Registry.SetValue(keyName, "Enabled", logSet);
     if(logOn == true)
        MessageBox.Show("Interop Logging On");
     else
        MessageBox.Show("Interop Logging Off");
     }
     catch(System.Exception ex)
     {
        MessageBox.Show(ex.Message);
     }
}

// This method sets the Enabled key value to 1// so that logging for class loading is enabled.privatevoid SetLoaderLogging(bool logOn)
{
    // Specify values for setting the registry.string userRoot = "HKEY_LOCAL_MACHINE";
    string subkey = "Software\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Loader";
    string keyName = userRoot + "\\" + subkey;

    int logSet;
    if(logOn == true)
    logSet = 1;
    else
    logSet = 0;

    // Set the registry value.try
    {
        Registry.SetValue(keyName, "Enabled", logSet);
        if(logOn == true)
        MessageBox.Show("Loader Logging On");
        else
        MessageBox.Show("Loader Logging Off");
    }
    catch(System.Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

  // This method sets the Enabled key value to 1// so that logging for networking is enabled.privatevoid SetNetworkLogging(bool logOn)
  {
    // Specify values for setting the registry.string userRoot = "HKEY_LOCAL_MACHINE";
    string subkey = "Software\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Network";
    string keyName = userRoot + "\\" + subkey;

    int logSet;
    if(logOn == true)
      logSet = 1;
    else
      logSet = 0;

    // Set the registry value.try
    {
         Registry.SetValue(keyName, "Enabled", logSet);
         if(logOn == true)
            MessageBox.Show("Networking Logging On");
         else
            MessageBox.Show("Networking Loggin Off");
     }
     catch(System.Exception ex)
     {
        MessageBox.Show(ex.Message);
     }
  }

// This method disables all logging.privatevoid DisableLogging()
{
    // Specify values for setting the registry.string userRoot = "HKEY_LOCAL_MACHINE";
    string subkey = "SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging";
    string keyName = userRoot + "\\" + subkey;

    // Set the Enabled registry value.
    Registry.SetValue(keyName, "Enabled", 0);
    MessageBox.Show("Logging Disabled");
}

// This method recursively examines the keys// under the Logging subkey and writes their// key names and values to a log file. It saves// the information in "logsettings.txt" located
// in the directory that contains this // example application.privatevoid WriteLoggingSettings()
{
    StreamWriter sw = new StreamWriter("logsettings.txt",false);
    sw.WriteLine("General Logging Settings:");
    RegistryKey rkLogging = Registry.LocalMachine.OpenSubKey("SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging");
    string[] valNames = rkLogging.GetValueNames();
    for (int x = 0; x < valNames.Length; x++)
    {
        sw.WriteLine(valNames[x].ToString() + ": " + rkLogging.GetValue(valNames[x]).ToString());
    }

    sw.WriteLine();
    sw.WriteLine("Interop Logging:");
    RegistryKey rkInterop = Registry.LocalMachine.OpenSubKey("SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Interop");
    string[] interopNames = rkInterop.GetValueNames();
    for (int x = 0; x < interopNames.Length; x++)
    {
        sw.WriteLine(interopNames[x].ToString() + ": " + rkInterop.GetValue(interopNames[x]).ToString());
    }

    sw.WriteLine();
    sw.WriteLine("Loader Logging:");
    RegistryKey rkLoader = Registry.LocalMachine.OpenSubKey("SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Loader");
    string[] loaderNames = rkLoader.GetValueNames();
    for (int x = 0; x < loaderNames.Length; x++)
    {
        sw.WriteLine(loaderNames[x].ToString() + ": " + rkLoader.GetValue(loaderNames[x]).ToString());
    }

    sw.WriteLine();
    sw.WriteLine("Networking Logging:");
    RegistryKey rkNetworking = Registry.LocalMachine.OpenSubKey("SOFTWARE\\Microsoft\\.NETCompactFramework\\Diagnostics\\Logging\\Network");
    string[] netNames = rkNetworking.GetValueNames();
    for (int x = 0; x < netNames.Length; x++)
    {
        sw.WriteLine(netNames[x].ToString() + ": " + rkNetworking.GetValue(netNames[x]).ToString());
    }
   sw.Close();
}

コードのコンパイル方法

この例では、次の名前空間への参照が必要です。

参照

概念

ログファイルの情報

その他の技術情報

最適化フレームワークのパフォーマンスと、.NET での診断

方法 : ログ ファイルを作成します。

ログの記録を有効にするには

(省略可能)、ログ ファイルのパスを指定

名前 (省略可能) に、アプリケーションを含める

名前 (省略可能) に、プロセス ID を含める

(省略可能) が発生するイベントを記録

相互運用ログ

相互運用ログを有効にするには

エラー ログの記録

エラー ログを有効にするには

ローダー ログ

ローダー ログを有効にするには

ネットワーク ログの記録

ネットワーク ログを有効にするには