Log - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.logging
Klasse	public class Log
Vererbung	Log Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bietet pseudo-hierarchische Protokollfunktionen mit verschiedenen Optionen für Format und Ausgabe. Das Protokollsystem besteht aus zwei Hauptkomponenten: der Protokollfunktion und einem Ziel. Mithilfe der Protokollfunktion können Sie Informationen an ein Ziel senden. Das Ziel ist für die Formatierung und die allgemeinen Ausgabe der Protokolldaten verantwortlich.

Protokollfunktionen sind Singleton-Instanzen, die für eine bestimmte Kategorie von Informationen erstellt wurden. Normalerweise ist die Kategorie der Paketname der Komponente, die Informationen protokollieren möchte. Mithilfe der Kategorie können Benutzer angeben, welche Protokollinformationen sie interessieren. Es können verschiedene Kategorien ausgewählt und mit regulären Ausdrücken kombiniert werden. Dadurch können weit- als auch engmaschige Protokollinformationen erhalten werden. Beispielsweise können Sie an allen Protokollinformationen unter den Paketen „mx.messaging“ und „mx.rpc“ interessiert sein und möchten die Ausgabe aus diesen Paketen als XML formatieren. Um alle Protokollinformationen unter der Kategorie „mx.messaging“ einschließlich untergeordneter Pakete und Komponenten zu erhalten, ist ein Platzhalterausdruck (z. B. „mx.messaging.*“) erforderlich.*". Ausführliche Informationen finden Sie im folgenden Codebeispiel.

Ziele bieten den Ausgabemechanismus der zu protokollierenden Daten. Dieser Mechanismus enthält normalerweise Formatierung, Übertragung oder Speicherung, kann jedoch ein beliebiger Vorgang auf VM sein. Zwei Ziele werden zur Verfügung gestellt: MiniDebugTarget und TraceTarget. Jede dieser Schreibefunktionen nimmt die aktuellen Protokollinformationen und sendet sie zur Anzeige und/oder Speicherung. Ziele bieten auch die Spezifikation, welche Protokolldaten ausgegeben werden sollen.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addTarget(target:mx.logging:ILoggingTarget):void [statisch] Ermöglicht dem angegeben Ziel das Empfangen von Benachrichtigungen zu Protokollereignissen.	Log
		flush():void [statisch] Diese Methode entfernt alle aktuellen Protokollfunktionen aus dem Cache.	Log
		getLogger(category:String):ILogger [statisch] Gibt die Protokollfunktion zurück, die mit der angegebenen Kategorie verknüpft ist.	Log
		hasIllegalCharacters(value:String):Boolean [statisch] Diese Methode überprüft den angegebenen Stringwert auf unzulässige Zeichen.	Log
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isDebug():Boolean [statisch] Gibt an, ob das Protokollereignis einer Debug-Stufe von einem Protokollziel verarbeitet werden soll.	Log
		isError():Boolean [statisch] Gibt an, ob das Protokollereignis einer Fehlerstufe von einem Protokollziel verarbeitet werden soll.	Log
		isFatal():Boolean [statisch] Gibt an, ob das Protokollereignis einer Fehlerstufe von einem Protokollziel verarbeitet werden soll.	Log
		isInfo():Boolean [statisch] Gibt an, ob das Protokollereignis einer Informationsstufe von einem Protokollziel verarbeitet werden soll.	Log
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		isWarn():Boolean [statisch] Gibt an, ob das Protokollereignis einer Warnstufe von einem Protokollziel verarbeitet werden soll.	Log
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeTarget(target:mx.logging:ILoggingTarget):void [statisch] Beendet beim angegebenen Ziel das Empfangen von Benachrichtigungen zu Protokollereignissen.	Log
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Methodendetails

addTarget

()

Methode

public static function addTarget(target:mx.logging:ILoggingTarget):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ermöglicht dem angegeben Ziel das Empfangen von Benachrichtigungen zu Protokollereignissen.

Parameter

target:mx.logging:ILoggingTarget — Bestimmtes Ziel, das Protokollereignisse erfassen soll.

flush

()

Methode

public static function flush():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode entfernt alle aktuellen Protokollfunktionen aus dem Cache. Nachfolgende Aufrufe der getLogger()-Methode geben neue Instanzen von Protokollfunktionen anstatt frühere Instanzen mit der gleichen Kategorie zurück. Diese Methode ist nur zur Verwendung beim Debugging gedacht.

getLogger

()

Methode

public static function getLogger(category:String):ILogger

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt die Protokollfunktion zurück, die mit der angegebenen Kategorie verknüpft ist. Wenn die angegebene Kategorie nicht vorhanden ist, wird eine neue Instanz einer Protokollfunktion zurückgegeben und mit dieser Kategorie verknüpft. Kategorien müssen die Länge von mindestens einem Zeichen aufweisen und dürfen keine Leerzeichen oder eines der folgenden Zeichen enthalten: []~$^&\/(){}<>+=`!#%?,:;'"@ Diese Methode gibt einen InvalidCategoryError zurück, wenn die angegebenen Kategorie falsch formatiert ist.

Parameter

category:String — Die Kategorie der Protokollfunktion, die zurückgegeben werden soll.

Rückgabewerte

ILogger — Eine Instanz eines Protokollobjeks für den angegebenen Namen. Wenn der Name nicht vorhanden ist, wird eine neue Instanz mit dem angegebenen Namen zurückgegeben.

hasIllegalCharacters

()

Methode

public static function hasIllegalCharacters(value:String):Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Diese Methode überprüft den angegebenen Stringwert auf unzulässige Zeichen.

Parameter

value:String — Der String, der auf unzulässige Zeichen überprüft werden soll. Die folgenden Zeichen sind nicht gültig: []~$^&\/(){}<>+=`!#%?,:;'"@

Rückgabewerte

Boolean — Wert true, wenn unzulässige Zeichen gefunden wurden, andernfalls Wert false.

isDebug

()

Methode

public static function isDebug():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob das Protokollereignis einer Debug-Stufe von einem Protokollziel verarbeitet werden soll.

Rückgabewerte

Boolean — Wert „true“, wenn das Protokollereignis einer Debug-Stufe protokolliert werden soll, andernfalls „false“.

isError

()

Methode

public static function isError():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob das Protokollereignis einer Fehlerstufe von einem Protokollziel verarbeitet werden soll.

Rückgabewerte

Boolean — Wert „true“, wenn das Protokollereignis einer Fehlerstufe protokolliert werden soll, andernfalls „false“.

isFatal

()

Methode

public static function isFatal():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob das Protokollereignis einer Fehlerstufe von einem Protokollziel verarbeitet werden soll.

Rückgabewerte

Boolean — Wert „true“, wenn das Protokollereignis einer schwerwiegenden Stufe protokolliert werden soll, andernfalls „false“.

isInfo

()

Methode

public static function isInfo():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob das Protokollereignis einer Informationsstufe von einem Protokollziel verarbeitet werden soll.

Rückgabewerte

Boolean — Wert „true“, wenn das Protokollereignis einer Informationsstufe protokolliert werden soll, andernfalls „false“.

isWarn

()

Methode

public static function isWarn():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob das Protokollereignis einer Warnstufe von einem Protokollziel verarbeitet werden soll.

Rückgabewerte

Boolean — Wert „true“, wenn das Protokollereignis einer Warnstufe protokolliert werden soll, andernfalls „false“.

removeTarget

()

Methode

public static function removeTarget(target:mx.logging:ILoggingTarget):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Beendet beim angegebenen Ziel das Empfangen von Benachrichtigungen zu Protokollereignissen.

Parameter

target:mx.logging:ILoggingTarget — Bestimmtes Ziel, das Protokollereignisse erfassen soll.

Rechtliche Hinweise | Onlinedatenschutzerklärung

Log - AS3 Flex

Klassen x

addTarget

flush

getLogger

hasIllegalCharacters

isDebug

isError

isFatal

isInfo

isWarn

removeTarget