Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: サーバーからデータを取得しています...
サーバーからデータを取得しています...
mx.logging 

Log  - AS3 Flex

パッケージmx.logging
クラスpublic class Log
継承Log Inheritance Object

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

複数の書式オプションおよび出力オプションを有する擬似階層構造のロギング機能を提供します。 ログシステムは、ロガーとターゲットという 2 つの主なコンポーネントで構成されています。 ロガーを使用してターゲットに情報を送信することができます。 ターゲットは、ログデータのフォーマットや一般的な出力を行います。

ロガーは、特定のカテゴリの情報用に作成されたシングルトンインスタンスです。 通常、カテゴリは、情報を記録する必要があるコンポーネントのパッケージ名です。 カテゴリにより、ユーザーは興味のあるログ情報を指定できます。複数のカテゴリを選択したり、正規表現で組み合わせることができます。 これにより、広範囲なログ情報と絞り込んだログ情報の両方を取得できます。 例えば、mx.messaging パッケージと mx.rpc パッケージ配下のすべてのログ情報を取得し、これらのパッケージの出力を XML でフォーマットしたいとします。 サブパッケージやコンポーネントを含む、mx.messaging カテゴリ配下のすべてのログ情報を取得するには、mx.messaging.* などのワイルドカード表現が必要になります。詳細は、以下のコード例を参照してください。

ターゲットは、記録対象のデータの出力メカニズムを提供します。 通常このメカニズムには、フォーマット、転送、保存などがありますが、VM 配下の任意のものを使用できます。 次の 2 種類のターゲットが提供されています。MiniDebugTarget および TraceTarget。 これらの各ライターは、現在のログ情報を取得し、表示と保存のうちの一方または両方を行うための場所にそれを送信します。 ターゲットは、出力するログデータも指定します。

さらに例を参照



パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
パブリックメソッド
 メソッド定義元
  
[静的] 指定されたターゲットで、ログイベントの通知の受信を開始します。
Log
  
[静的] このメソッドは、キャッシュから現在のロガーをすべて削除します。
Log
  
[静的] 指定されたカテゴリに関連付けられたロガーを返します。
Log
  
[静的] このメソッドにより、指定されたストリング値に無効な文字がないかどうかがチェックされます。
Log
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
[静的] DEBUG レベルのログイベントをログターゲットにより処理するかどうかを指定します。
Log
  
[静的] ERROR レベルのログイベントをログターゲットにより処理するかどうかを指定します。
Log
  
[静的] FATAL レベルのログイベントをログターゲットにより処理するかどうかを指定します。
Log
  
[静的] INFO レベルのログイベントをログターゲットにより処理するかどうかを指定します。
Log
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
[静的] WARN レベルのログイベントをログターゲットにより処理するかどうかを指定します。
Log
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
[静的] 指定されたターゲットで、ログイベントの通知の受信を停止します。
Log
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
メソッドの詳細

addTarget

()メソッド
public static function addTarget(target:mx.logging:ILoggingTarget):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

指定されたターゲットで、ログイベントの通知の受信を開始します。

パラメーター

target:mx.logging:ILoggingTarget — ログイベントをキャプチャする特定のターゲットです。

flush

()メソッド 
public static function flush():void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

このメソッドは、キャッシュから現在のロガーをすべて削除します。 getLogger() メソッドを引き続き呼び出すと、同じカテゴリの前のインスタンスでなく、ロガーの新しいインスタンスが返されます。 このメソッドは、デバッグ専用に使用します。

getLogger

()メソッド 
public static function getLogger(category:String):ILogger

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

指定されたカテゴリに関連付けられたロガーを返します。 指定されたカテゴリが存在しない場合、ロガーの新しいインスタンスが返され、そのカテゴリと関連付けられます。 カテゴリの長さは 1 文字以上で、空白を含む次の文字は使用できません。[]~$^&¥/(){}<>+=`!#%?,:;'"@指定されたカテゴリの形式が正しくない場合は、このメソッドにより InvalidCategoryError がスローされます。

パラメーター

category:String — 返す必要があるロガーのカテゴリです。

戻り値
ILogger — 指定された名前のロガーオブジェクトのインスタンスです。 その名前が存在しない場合、指定された名前を持つ新しいインスタンスが返されます。

hasIllegalCharacters

()メソッド 
public static function hasIllegalCharacters(value:String):Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

このメソッドにより、指定されたストリング値に無効な文字がないかどうかがチェックされます。

パラメーター

value:String — 無効な文字をチェックするストリングです。 次の文字は有効ではありません。[]~$^&¥/(){}<>+=`!#%?,:;'"@

戻り値
Boolean — 無効な文字が検出された場合は true で、それ以外の場合は false になります。

isDebug

()メソッド 
public static function isDebug():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

DEBUG レベルのログイベントをログターゲットにより処理するかどうかを指定します。

戻り値
Boolean — DEBUG レベルのログイベントを記録する場合は true で、それ以外の場合は false です。

isError

()メソッド 
public static function isError():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

ERROR レベルのログイベントをログターゲットにより処理するかどうかを指定します。

戻り値
Boolean — ERROR レベルのログイベントを記録する場合は true で、それ以外の場合は false です。

isFatal

()メソッド 
public static function isFatal():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

FATAL レベルのログイベントをログターゲットにより処理するかどうかを指定します。

戻り値
Boolean — FATAL レベルのログイベントを記録する場合は true で、それ以外の場合は false です。

isInfo

()メソッド 
public static function isInfo():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

INFO レベルのログイベントをログターゲットにより処理するかどうかを指定します。

戻り値
Boolean — INFO レベルのログイベントを記録する場合は true で、それ以外の場合は false です。

isWarn

()メソッド 
public static function isWarn():Boolean

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

WARN レベルのログイベントをログターゲットにより処理するかどうかを指定します。

戻り値
Boolean — WARN レベルのログイベントを記録する場合は true で、それ以外の場合は false です。

removeTarget

()メソッド 
public static function removeTarget(target:mx.logging:ILoggingTarget):void

言語バージョン: ActionScript 3.0
製品バージョン: Flex 3
ランタイムバージョン: Flash Player 9, AIR 1.1

指定されたターゲットで、ログイベントの通知の受信を停止します。

パラメーター

target:mx.logging:ILoggingTarget — ログイベントをキャプチャする特定のターゲットです。





[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。