Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Befehle
Unterbefehle
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>FileSetAttrib</h1> <p>Ändert die Attribute von ein oder mehreren Dateien oder Ordnern. Platzhalter werden unterstützt.</p> <pre class="Syntax"><span class="func">FileSetAttrib</span>, Attribute <span class="optional">, DateiMuster, OrdnerEinbeziehen, Rekursiv</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>Attribute</dt> <dd><p>Attribute, die geändert werden sollen. Zum Beispiel <code>+HA-R</code>.</p> <p>Um Attribute einfach ein-, aus- oder umzuschalten, stellen Sie einem oder mehreren der folgenden Attributbuchstaben ein Pluszeichen (+), Minuszeichen (-) oder Zirkumflex (^) voran:</p> <ul> <li>R = READONLY (schreibgeschützt)</li> <li>A = ARCHIVE (archiviert)</li> <li>S = SYSTEM (Systemdatei)</li> <li>H = HIDDEN (versteckt)</li> <li>N = NORMAL (nur ohne die anderen Attribute gültig)</li> <li>O = OFFLINE</li> <li>T = TEMPORARY (temporär)</li> </ul> <p class="note"><strong>Hinweis:</strong> Derzeit kann der Komprimierungsstatus von Dateien mit diesem Befehl nicht geändert werden.</p> </dd> <dt>DateiMuster</dt> <dd>Wenn leer oder weggelassen, wird die aktuelle Datei der innersten umschlossenen <a href="LoopFile.htm">Datei-Schleife</a> verwendet. Andernfalls geben Sie den Namen einer Datei oder eines Ordners oder ein Platzhaltermuster wie z.B. <code>C:\Temp\*.tmp</code> an. Wenn kein absoluter Pfad angegeben ist, wird <em>DateiMuster</em> im <a href="../Variables.htm#WorkingDir">A_WorkingDir</a>-Verzeichnis vermutet.</dd> <dt>OrdnerEinbeziehen</dt> <dd><p>Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:</p> <ul> <li>0 = Ordner werden nicht mit einbezogen (nur Dateien).</li> <li>1 = Alle Dateien und Ordner, die dem Platzhaltermuster entsprechen, werden mit einbezogen.</li> <li>2 = Nur Ordner werden mit einbezogen (keine Dateien).</li> </ul> <p class="note"><strong>Hinweis:</strong> Wenn <em>DateiMuster</em> ein einzelner Ordner anstelle eines Platzhaltermusters ist, wird er immer mit einbezogen, unabhängig von dieser Einstellung.</p> <p>Dieser Parameter kann ein <a href="../Variables.htm#Expressions">Ausdruck</a> sein.</p></dd> <dt>Rekursiv</dt> <dd><p>Wenn leer oder weggelassen, wird standardmäßig 0 verwendet. Andernfalls geben Sie eine der folgenden Ziffern an:</p> <ul> <li>0 = Unterordner werden nicht rekursiv durchwandert.</li> <li>1 = Unterordner werden rekursiv durchwandert, d.h. auch alle darin befindlichen Dateien und Ordner, die dem <em>DateiMuster</em> entsprechen, werden mit einbezogen. Es werden alle Unterordner rekursiv durchwandert, nicht nur solche, die dem <em>DateiMuster</em> entsprechen. Dateien und Ordner, deren vollständiger Pfadname länger als 259 Zeichen ist, werden übersprungen, als wären sie nicht vorhanden. Dieses Problem tritt jedoch nur selten auf, weil das Betriebssystem solche Pfadnamen normalerweise nicht erlaubt.</li> </ul> <p>Dieser Parameter kann ein <a href="../Variables.htm#Expressions">Ausdruck</a> sein.</p></dd> </dl> <h2 id="Error_Handling">Fehlerbehandlung</h2> <p><span class="ver">[v1.1.04+]</span>: Dieser Befehl ist in der Lage, bei Misserfolg eine Ausnahme auszulösen. Weitere Informationen finden Sie unter <a href="Catch.htm#RuntimeErrors">Laufzeitfehler</a>.</p> <p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> wird bei <u>Misserfolg</u> auf die Anzahl der Dateien gesetzt, die nicht geändert werden konnten, und bei Erfolg auf 0.</p> <p>Wenn Dateien gefunden wurden, wird <a href="../Variables.htm#LastError">A_LastError</a> auf 0 oder das Ergebnis der Systemfunktion GetLastError() unmittelbar nach dem letzten Misserfolg gesetzt. Andernfalls enthält A_LastError einen Fehlercode, der eventuell kenntlich macht, warum keine Dateien gefunden wurden.</p> <h2 id="Related">Siehe auch</h2> <p><a href="FileGetAttrib.htm">FileGetAttrib</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FileSetTime.htm">FileSetTime</a>, <a href="FileGetSize.htm">FileGetSize</a>, <a href="FileGetVersion.htm">FileGetVersion</a>, <a href="LoopFile.htm">Datei-Schleife</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExTurnOnMultiple"> <p><a class="ex_number" href="#ExTurnOnMultiple"></a> Schaltet das READONLY- und HIDDEN-Attribut für alle Dateien und Verzeichnisse ein (Unterverzeichnisse werden nicht rekursiv durchwandert).</p> <pre>FileSetAttrib, +RH, C:\MeineDateien\*.*, 1 <em>; +RH ist identisch mit +R+H</em></pre> </div> <div class="ex" id="ExToggle"> <p><a class="ex_number" href="#ExToggle"></a> Schaltet das HIDDEN-Attribut eines einzelnen Verzeichnisses um.</p> <pre>FileSetAttrib, ^H, C:\MeineDateien</pre> </div> <div class="ex" id="ExMixed"> <p><a class="ex_number" href="#ExMixed"></a> Schaltet das READONLY-Attribut einer einzelnen Datei aus und ihr ARCHIVE-Attribut ein.</p> <pre>FileSetAttrib, -R+A, C:\Neue Textdatei.txt</pre> </div> <div class="ex" id="ExRecurse"> <p><a class="ex_number" href="#ExRecurse"></a> Durchwandert rekursiv alle INI-Dateien auf dem C-Laufwerk und schaltet deren ARCHIVE-Attribut ein.</p> <pre>FileSetAttrib, +A, C:\*.ini, , 1</pre> </div> </body> </html>