FileHandler Klasse

Referenz

Definition

Namespace:: Java.Util.Logging

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Einfache Dateiprotokollierung Handler.

[Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)]
public class FileHandler : Java.Util.Logging.StreamHandler

[<Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)>]
type FileHandler = class
    inherit StreamHandler

Vererbung: Object

Object

Handler

StreamHandler
FileHandler

Attribute: RegisterAttribute

Hinweise

Einfache Dateiprotokollierung Handler.

Die FileHandler Datei kann entweder in eine angegebene Datei geschrieben oder in eine gedrehte Gruppe von Dateien geschrieben werden.

Bei einem gedrehten Satz von Dateien wird die Datei geschlossen, gedreht und eine neue Datei geöffnet, da jede Datei eine bestimmte Größenbeschränkung erreicht. Aufeinanderfolgende ältere Dateien werden durch Hinzufügen von "0", "1", "2" usw. in den Basisdateinamen benannt.

Standardmäßig ist die Pufferung in den E/A-Bibliotheken aktiviert, aber jeder Protokolldatensatz wird nach Abschluss des Vorgangs geleert.

Standardmäßig wird die Klasse für die XMLFormatter Formatierung verwendet.

<b>Configuration:</b> Standardmäßig wird jede FileHandler mithilfe der folgenden LogManager Konfigurationseigenschaften initialisiert, wobei <handler-name> auf den vollqualifizierten Klassennamen des Handlers verwiesen wird. Wenn Eigenschaften nicht definiert sind (oder ungültige Werte aufweisen), werden die angegebenen Standardwerte verwendet. <ul><li> < Handlername>. Die Ebene gibt die Standardebene für die Handler (Standardwerte) an Level.ALL. </li><li> < Handlername>. filter specifies the name of a Filter class to use (defaults to no Filter). </li><li> < Handlername>. Formatierer gibt den Namen einer Formatter zu verwendenden Klasse an (Standardeinstellung java.util.logging.XMLFormatter) </li li>>< < Handlername>. Codierung des Namens der zu verwendenden Zeichensatzcodierung (Standardeinstellung für die Standardplattformcodierung). </li><li> < Handlername>. limit specifies an approximate maximum amount to write (in bytes) to any one file. Wenn dies null ist, gibt es kein Limit. (Standardwert ist kein Grenzwert). </li><li> < Handlername>. Anzahl gibt an, wie viele Ausgabedateien durchlaufen werden sollen (Standardwert ist 1). </li><li> < Handlername>. Das Muster gibt ein Muster zum Generieren des Ausgabedateinamens an. Details finden Sie weiter unten. (Standardwert ist "%h/java%u.log"). </li><li> < Handlername>. append specifies whether the FileHandler should append to any existing files (defaults to false). </li></ul>

BeispielFileHandler: <ul<>li> java.util.logging.FileHandler.level=INFO /li<>> java.util.logging.FileHandler.formatter=java.util.logging.formatter=java.util.logging.SimpleFormatter </li<>/ul <>

Für einen benutzerdefinierten Handler lautet e.g. com.foo.MyHandler die Eigenschaften: ul>li com.foo.MyHandler.level=INFO </li<>> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li<>/ul><<>

Ein Muster besteht aus einer Zeichenfolge, die die folgenden speziellen Komponenten enthält, die zur Laufzeit ersetzt werden: ul>li "/" das lokale Pfadnamentrennzeichen </li "%t" das temporäre Systemverzeichnis </li<>> li "%h" den Wert der Systemeigenschaft <"user.home" /li><> li "%g" die Generationsnummer, um gedrehte Protokolle </li<>>><> "%u" eine eindeutige Zahl zu unterscheiden, um Konflikte </li li zu lösen>><><< "%%" übersetzt in ein einzelnes Prozentzeichen "%" </li></ul> Wenn kein Feld "%g" angegeben wurde und die Dateianzahl größer als eins ist, wird die Generationsnummer am Ende des generierten Dateinamens nach einem Punkt hinzugefügt.

So würde beispielsweise ein Muster von "%t/java%g.log" mit der Anzahl 2 in der Regel dazu führen, dass Protokolldateien auf Solaris in /var/tmp/java0.log und /var/tmp/java1.log geschrieben werden, während sie in Windows 95 normalerweise in C:\TEMP\java0.log und C:\TEMP\java1.log

Generierungsnummern folgen der Sequenz 0, 1, 2 usw.

Normalerweise ist das eindeutige Feld "%u" auf 0 festgelegt. Wenn jedoch versucht FileHandler wird, den Dateinamen zu öffnen und findet, dass die Datei zurzeit von einem anderen Prozess verwendet wird, erhöht es das Feld für die eindeutige Zahl, und versuchen Sie es erneut. Dies wird wiederholt, bis FileHandler ein Dateiname gefunden wird, der derzeit nicht verwendet wird. Wenn ein Konflikt vorliegt und kein Feld "%u" angegeben wurde, wird es am Ende des Dateinamens nach einem Punkt hinzugefügt. (Dies erfolgt nach jeder automatisch hinzugefügten Generationsnummer.)

Wenn also drei Prozesse alle versuchen, sich bei fred%u.%g.txt zu protokollieren, verwenden sie möglicherweise fred0.0.txt, fred1.0.txt, fred2.0.txt als erste Datei in ihren drehbaren Sequenzen.

Beachten Sie, dass die Verwendung eindeutiger IDs, um Konflikte zu vermeiden, nur zuverlässig funktioniert, wenn ein lokales Datenträgerdateisystem verwendet wird.

In 1.4 hinzugefügt.

Java-Dokumentation für java.util.logging.FileHandler.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

FileHandler()	Erstellen sie eine Standardeinstellung `FileHandler`.
FileHandler(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.
FileHandler(String)	Initialisieren Sie einen `FileHandler` Zuschreibungstyp in den angegebenen Dateinamen.
FileHandler(String, Boolean)	Initialisieren Sie einen `FileHandler` Zuschreibungstyp in den angegebenen Dateinamen mit optionalem Anfügen.
FileHandler(String, Int32, Int32)	Initialisieren Sie eine `FileHandler` Datei, die in eine Gruppe von Dateien geschrieben werden soll.
FileHandler(String, Int32, Int32, Boolean)	Initialisieren Sie einen `FileHandler` Zuschreibungsvorgang in eine Gruppe von Dateien mit optionalem Anfüge.

Eigenschaften

Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Encoding	Gibt die Zeichencodierung für dieses `Handler`Zurück. -oder- Legen Sie die zeichencodierung fest, die von diesem `Handler`verwendet wird. (Geerbt von Handler)
ErrorManager	Ruft den ErrorManager für diesen Handler ab. - oder- Definieren Sie einen ErrorManager für diesen Handler. (Geerbt von Handler)
Filter	Abrufen des aktuellen `Filter` Für dieses Themas `Handler`. -oder- Legen Sie einen `Filter` Zum Steuern der Ausgabe auf dieses `Handler`. (Geerbt von Handler)
Formatter	Gibt dies `Formatter` zurück `Handler`. -or- Set a `Formatter`. (Geerbt von Handler)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
JniPeerMembers	Einfache Dateiprotokollierung `Handler`.
Level	Rufen Sie die Protokollebene ab, die angibt, welche Nachrichten von diesem `Handler`protokolliert werden sollen. -oder- Legen Sie die Protokollebene fest, die angibt, welche Nachrichtenebenen von diesem `Handler`protokolliert werden sollen. (Geerbt von Handler)
PeerReference	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Close()	Schließen Sie den aktuellen Ausgabedatenstrom. (Geerbt von StreamHandler)
Dispose()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
Dispose(Boolean)	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
Flush()	Leeren Sie alle gepufferten Nachrichten. (Geerbt von StreamHandler)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
IsLoggable(LogRecord)	Überprüfen Sie, ob dies tatsächlich ein bestimmtes `HandlerLogRecord`Protokoll protokolliert. (Geerbt von Handler)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
Publish(LogRecord)	Formatieren und Veröffentlichen eines `LogRecord`. (Geerbt von StreamHandler)
ReportError(String, Exception, Int32)	Geschützte Komfortmethode, um einen Fehler an den ErrorManager dieses Handlers zu melden. (Geerbt von Handler)
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetOutputStream(Stream)	Ändern Sie den Ausgabedatenstrom. (Geerbt von StreamHandler)
ToArray<T>()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.Finalized()	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Einfache Dateiprotokollierung `Handler`. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Einfache Dateiprotokollierung `Handler`.
GetJniTypeName(IJavaPeerable)	Einfache Dateiprotokollierung `Handler`.

Gilt für:

Freigeben über