Workbooks.OpenText Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Loads and parses a text file as a new workbook with a single sheet that contains the parsed text-file data.
public void OpenText (string Filename, object Origin, object StartRow, object DataType, Microsoft.Office.Interop.Excel.XlTextQualifier TextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, object ConsecutiveDelimiter, object Tab, object Semicolon, object Comma, object Space, object Other, object OtherChar, object FieldInfo, object TextVisualLayout, object DecimalSeparator, object ThousandsSeparator, object TrailingMinusNumbers, object Local);Public Sub OpenText (Filename As String, Optional Origin As Object, Optional StartRow As Object, Optional DataType As Object, Optional TextQualifier As XlTextQualifier = Microsoft.Office.Interop.Excel.XlTextQualifier.xlTextQualifierDoubleQuote, Optional ConsecutiveDelimiter As Object, Optional Tab As Object, Optional Semicolon As Object, Optional Comma As Object, Optional Space As Object, Optional Other As Object, Optional OtherChar As Object, Optional FieldInfo As Object, Optional TextVisualLayout As Object, Optional DecimalSeparator As Object, Optional ThousandsSeparator As Object, Optional TrailingMinusNumbers As Object, Optional Local As Object)Parameters
- Filename
- String
Required String. Specifies the file name of the text file to be opened and parsed.
- Origin
- Object
Optional Object. Specifies the origin of the text file. Can be one of the following XlPlatform constants: xlMacintosh, xlWindows, or xlMSDOS. Additionally, this could be an integer representing the code page number of the desired code page. For example, "1256" would specify that the encoding of the source text file is Arabic (Windows). If this argument is omitted, the method uses the current setting of the File Origin option in the Text Import Wizard.
- StartRow
- Object
Optional Object. The row number at which to start parsing text. The default value is 1.
- DataType
- Object
Optional Object. Specifies the column format of the data in the file. Can be one of the following XlTextParsingType constants: xlDelimited or xlFixedWidth. If this argument is not specified, Microsoft Excel attempts to determine the column format when it opens the file.
- TextQualifier
- XlTextQualifier
Optional XlTextQualifier. Specifies the text qualifier. Can be one of these XlTextQualifier constants.xlTextQualifierDoubleQuotedefaultxlTextQualifierNonexlTextQualifierSingleQuote
- ConsecutiveDelimiter
- Object
Optional Object. True to have consecutive delimiters considered one delimiter. The default is False.
- Tab
- Object
Optional Object. True to have the tab character be the delimiter (DataType must be xlDelimited). The default value is False.
- Semicolon
- Object
Optional Object. True to have the semicolon character be the delimiter (DataType must be xlDelimited). The default value is False.
- Comma
- Object
Optional Object. True to have the comma character be the delimiter (DataType must be xlDelimited). The default value is False.
- Space
- Object
Optional Object. True to have the space character be the delimiter (DataType must be xlDelimited). The default value is False.
- Other
- Object
Optional Object. True to have the character specified by the OtherChar argument be the delimiter (DataType must be xlDelimited). The default value is False.
- OtherChar
- Object
Optional Object (required if Other is True). Specifies the delimiter character when Other is True. If more than one character is specified, only the first character of the string is used; the remaining characters are ignored.
- FieldInfo
- Object
Optional XlColumnDataType. An array containing parse information for individual columns of data. The interpretation depends on the value of DataType. When the data is delimited, this argument is an array of two-element arrays, with each two-element array specifying the conversion options for a particular column. The first element is the column number (1-based), and the second element is one of theXlColumnDataType constants specifying how the column is parsed.xlGeneralFormat GeneralxlTextFormat TextxlMDYFormat MDY datexlDMYFormat DMY datexlYMDFormat YMD datexlMYDFormat MYD datexlDYMFormat DYM datexlYDMFormat YDM datexlEMDFormat EMD datexlSkipColumn Skip ColumnYou can use xlEMDFormat only if you have installed and selected Taiwanese language support. The xlEMDFormat constant specifies that Taiwanese era dates are being used.The column specifiers can be in any order. If there's no column specifier for a particular column in the input data, the column is parsed with the General setting.NotesIf you specify that a column is to be skipped, you must explicitly state the type for all remaining columns or the data will not parse correctly.If there is a recognizable date in the data, the cell will be formatted as a date in the worksheet even if the setting for the column is General. Additionally, if you specify one of the above date formats for a column and the data does not contain a recognized date, then the cell format in the worksheet will be General.If the source data has fixed-width columns, the first element in each two-element array specifies the position of the starting character in the column (as an integer; character 0 (zero) is the first character). The second element in the two-element array specifies the parse option for the column as a number between 0 and 9, as listed in the preceding table.
- TextVisualLayout
- Object
Optional Object. The visual layout of the text.
- DecimalSeparator
- Object
Optional Object. The decimal separator that Microsoft Excel uses when recognizing numbers. The default setting is the system setting.
- ThousandsSeparator
- Object
Optional Object. The thousands separator that Excel uses when recognizing numbers. The default setting is the system setting.The following table shows the results of importing text into Excel for various import settings. Numeric results are displayed in the rightmost column.
- TrailingMinusNumbers
- Object
Optional Object.
- Local
- Object
Optional Object.
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for