Workbooks.Open-Methode (Excel)
Öffnet eine Arbeitsmappe.
Hinweis
Haben Sie Interesse an der Entwicklung von Lösungen, mit denen die Funktionen von Office über mehrere Plattformen erweitert werden können? Schauen Sie sich das neue Office-Add-In-Modell an. Office-Add-Ins haben im Vergleich zu VSTO-Add-Ins und -Lösungen einen geringen Platzbedarf. Sie können sie mit fast jeder Web-Programmiertechnologie erstellen, z. B. HTML5, JavaScript, CSS3 und XML.
Syntax
Expression.Open (FileName, UpdateLinks, ReadOnly, Format, Password, WriteResPassword, IgnoreReadOnlyRecommended, Origin, Delimiter, Editable, Notify, Converter, AddToMru, Local, CorruptLoad)
Expression: Eine Variable, die ein Workbooks-Objekt darstellt.
Parameter
| Name | Erforderlich/Optional | Datentyp | Beschreibung |
|---|---|---|---|
| FileName | Optional | Variant | String. Der Dateiname der zu öffnenden Arbeitsmappe. |
| UpdateLinks | Optional | Variant | Gibt an, wie externe Bezüge (Links) in der Datei, z. B. der Verweis auf einen Bereich in der Arbeitsmappe „Budget.xls“ in der folgenden Formel, =SUM([Budget.xls]Annual!C10:C25)aktualisiert werden. Wenn dieses Argument ausgelassen wird, wird der Benutzer aufgefordert, anzugeben, wie Links aktualisiert werden. Weitere Informationen über die durch diesen Parameter verwendeten Werte finden Sie im Abschnitt „Hinweise“.Wenn Microsoft Excel eine Datei im WKS-, WK1- oder WK3-Format öffnet und das UpdateLinks-Argument „0“ ist, werden keine Diagramme erstellt. Andernfalls generiert Microsoft Excel Diagramme aus den an die Datei angefügten Diagrammen. |
| ReadOnly | Optional | Variant | „True“, um die Arbeitsmappe im schreibgeschützten Modus zu öffnen. |
| Format | Optional | Variant | Wenn Microsoft Excel eine Textdatei öffnet, gibt dieses Argument das Trennzeichen an. Wenn dieses Argument ausgelassen wird, wird das aktuelle Trennzeichen verwendet. Weitere Informationen über die durch diesen Parameter verwendeten Werte finden Sie im Abschnitt „Hinweise“. |
| Password | Optional | Variant | Eine Zeichenfolge, die das Kennwort enthält, das zum Öffnen einer geschützten Arbeitsmappe erforderlich ist. Wenn dieses Argument ausgelassen wird und für die Arbeitsmappe ein Kennwort erforderlich ist, wird der Benutzer aufgefordert, das Kennwort einzugeben. |
| WriteResPassword | Optional | Variant | Eine Zeichenfolge, die das Kennwort enthält, das zum Schreiben in eine schreibgeschützte Arbeitsmappe erforderlich ist. Wenn dieses Argument ausgelassen wird und für die Arbeitsmappe ein Kennwort erforderlich ist, wird der Benutzer aufgefordert, das Kennwort einzugeben. |
| IgnoreReadOnlyRecommended | Optional | Variant | True, damit Microsoft Excel nicht die Meldung in Bezug auf die Schreibschutzempfehlung anzeigt (wenn die Arbeitsmappe mit der Option Schreibschutz empfehlen gespeichert wurde). |
| Origin | Optional | Variant | Wenn die Datei eine Textdatei ist, gibt dieses Argument den entsprechenden Ursprung an, sodass die Codeseiten und Wagenrücklauf (Carriage Return, CR) / Zeilenvorschub (Line Feed, LF) richtig zugeordnet werden können. Kann eine der folgenden XlPlatform-Konstanten sein: xlMacintosh, xlWindows oder xlMSDOS. Wenn dieses Argument ausgelassen wird, wird das aktuelle Betriebssystem verwendet. |
| Delimiter | Optional | Variant | Wenn es sich bei der Datei um eine Textdatei handelt und das Format-Argument „6“ ist, handelt es sich bei diesem Argument um eine Zeichenfolge, die das Zeichen angibt, das als Trennzeichen verwendet werden soll. Verwenden Sie beispielsweise Chr(9) für Registerkarten, verwenden Sie „,“ für Kommas, verwenden Sie „;“ für Semikolons, oder verwenden Sie ein benutzerdefiniertes Zeichen. Nur das erste Zeichen der Zeichenfolge wird verwendet. |
| Editable | Optional | Variant | Wenn die Datei ein Microsoft Excel 4.0-Add-In ist, ist dieses Argument True zum Öffnen des Add-Ins, sodass es ein sichtbares Fenster ist. Wenn dieses Argument False ist oder ausgelassen wird, wird das Add-In ausgeblendet geöffnet und kann nicht eingeblendet werden. Diese Option trifft nicht auf in Microsoft Excel 5.0 oder höher erstellte Add-Ins zu. Wenn die Datei eine Excel-Vorlage ist, wird True zum Öffnen der angegebenen Vorlage zum Bearbeiten verwendet. False zum Öffnen einer neuen Arbeitsmappe auf Grundlage der angegebenen Vorlage. Der Standardwert lautet False. |
| Notify | Optional | Variant | Wenn die Datei nicht im Lese-/Schreibmodus geöffnet werden kann, ist das Argument True, um der Dateibenachrichtigungsliste die Datei hinzuzufügen. Microsoft Excel öffnet die Datei im schreibgeschützten Modus, ruft die Dateibenachrichtigungsliste ab und benachrichtigt den Benutzer anschließend, sobald die Datei verfügbar ist. Wenn dieses Argument False ist oder ausgelassen wird, ist keine Benachrichtigung erforderlich, und alle Versuche, die nicht verfügbare Datei zu öffnen, sind fehlerhaft. |
| Converter | Optional | Variant | Der Index des ersten Dateikonverters, der beim Öffnen der Datei ausprobiert werden soll. Der angegebene Dateikonverter wird zuerst ausprobiert. Wenn dieser Konverter die Datei nicht erkennt, werden alle anderen Konverter ausprobiert. Der Konverterindex besteht aus den Zeilennummern der Konverter, die von der FileConverter-Eigenschaft zurückgegeben werden. |
| AddToMru | Optional | Variant | Mit True wird diese Arbeitsmappe der Liste der zuletzt geöffneten Dateien hinzugefügt. Der Standardwert ist False. |
| Local | Optional | Variant | Mit True werden Dateien in der Sprache von Microsoft Excel (einschließlich der Einstellungen der Systemsteuerung) gespeichert. False (Standard) speichert Dateien mit der Sprache von Visual Basic for Applications (VBA) (was für gewöhnlich Englisch (USA) ist, es sei denn, das VBA-Projekt, wobei „Workbooks.Open“ ausgeführt wird, ist ein altes internationalisiertes XL5-/95-VBA-Projekt). |
| CorruptLoad | Optional | XlCorruptLoad | Kann eine der folgenden Konstanten sein: xlNormalLoad, xlRepairFile und xlExtractData. Das Standardverhalten, wenn kein Wert angegeben ist, ist xlNormalLoad, und es wird keine Wiederherstellung versucht, wenn der Start über das Objektmodell erfolgt. |
Rückgabewert
Ein Workbook-Objekt, das die geöffnete Arbeitsmappe darstellt.
Hinweise
Standardmäßig sind Makros beim programmatischen Öffnen von Dateien aktiviert. Verwenden Sie die AutomationSecurity-Eigenschaft, um den Makrosicherheitsmodus festzulegen, der beim programmatischen Öffnen von Dateien verwendet wird.
Sie können einen der folgenden Werte im Parameter UpdateLinks angeben, um zu bestimmen, ob externe Verweise (Links) beim Öffnen der Arbeitsmappe aktualisiert werden.
| Wert | Beschreibung |
|---|---|
| 0 | Externe Verweise (Verknüpfungen) werden beim Öffnen der Arbeitsmappe nicht aktualisiert. |
| 3 | Externe Verweise (Verknüpfungen) werden beim Öffnen der Arbeitsmappe aktualisiert. |
Sie können einen der folgenden Werte im Format-Parameter angeben, um das Trennzeichen für die Datei anzugeben.
| Wert | Trennzeichen |
|---|---|
| 1 | Registerkarten |
| 2 | Kommas |
| 3 | Leerzeichen |
| 4 | Semikolons |
| 5 | Nichts |
| 6 | Benutzerdefiniertes Zeichen (siehe das Argument Delimiter) |
Beispiel
Im folgenden Makrobeispiel wird die Arbeitsmappe „workbook Analysis.xls“ geöffnet, und anschließend wird das Makro „Auto_Open“ ausgeführt.
Workbooks.Open "ANALYSIS.XLS"
ActiveWorkbook.RunAutoMacros xlAutoOpen
Im folgenden Codebeispiel wird ein Blatt aus einer anderen Arbeitsmappe auf ein neues Blatt in der aktuellen Arbeitsmappe importiert. „Sheet1“ in der aktuellen Arbeitsmappe muss den Pfadnamen in Zelle D3, den Dateinamen in Zelle D4 und den Arbeitsblattnamen in Zelle D5 der zu importierenden Arbeitsmappe enthalten. Das importierte Arbeitsblatt wird hinter „Sheet1“ in der aktuellen Arbeitsmappe eingefügt.
Sub ImportWorksheet()
' This macro will import a file into this workbook
Sheets("Sheet1").Select
PathName = Range("D3").Value
Filename = Range("D4").Value
TabName = Range("D5").Value
ControlFile = ActiveWorkbook.Name
Workbooks.Open Filename:=PathName & Filename
ActiveSheet.Name = TabName
Sheets(TabName).Copy After:=Workbooks(ControlFile).Sheets(1)
Windows(Filename).Activate
ActiveWorkbook.Close SaveChanges:=False
Windows(ControlFile).Activate
End Sub
Support und Feedback
Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.