TextDocument.Read

TextDocument

Leer

Disponible desde la versión 8.0.

Variante de sintaxis: Desde un archivo

Sintaxis:

Leer(<NombreArchivo>, <TipoArchivo>, <SeparadorLinea>)

Parámetros:

<NombreArchivo> (obligatorio)

Tipo: String.
Nombre del archivo de texto.

<TipoArchivo> (opcional)

Tipo: TextEncoding, String.
Especifica el tipo de archivo que se está abriendo. Si se especifica un tipo para el archivo abierto, se leerá de acuerdo a ese tipo. Se generará una excepción si el formato real del archivo no coincide con el tipo especificado.
Si no se especifica el formato del archivo, se leerá como un archivo en formato UTF8, UTF16 o ANSI. Se generará una excepción si el archivo no se puede leer en ninguno de estos formatos.

El tipo de archivo se puede establecer tanto como el valor de la enumeración TextEncoding como como una cadena que indica el nombre de la codificación.
Nombres de codificaciones admitidos:

  • UTF-8
  • UTF-16
  • UTF-16BE
  • UTF-16LE
  • UTF-32
  • UTF-32BE
  • UTF-32LE
  • UTF16_PlatformEndian
  • UTF16_OppositeEndian
  • UTF32_PlatformEndian
  • UTF32_OppositeEndian
  • UTF-7
  • IMAP-mailbox-name
  • SCSU
  • BOCU-1
  • CESU-8
  • ISO-8859-1
  • US-ASCII
  • gb18030
  • IBM367
  • iso-8859-2
  • iso-8859-3
  • iso-8859-4
  • iso-8859-5
  • iso-8859-6
  • iso-8859-7
  • iso-8859-8
  • iso-8859-9
  • iso-8859-13
  • iso-8859-15
  • cp932
  • Shift_JIS
  • EUC-JP
  • cp33722
  • windows-950
  • Big5
  • cp950
  • Big5-HKSCS
  • cp1386
  • GBK
  • GB2312
  • GB_2312-80
  • cp964
  • cp949
  • cp949c
  • EUC-KR
  • ibm-971
  • KSC_5601
  • ibm-1363
  • windows-949
  • windows-874
  • cp874
  • ibm-1162
  • cp437
  • cp737
  • cp775
  • cp850
  • cp851
  • cp852
  • cp855
  • cp856
  • cp857
  • cp858
  • cp860
  • cp861
  • cp862
  • cp863
  • cp864
  • cp865
  • cp866
  • ibm-867
  • CP868
  • cp869
  • KOI8-R
  • ibm-901
  • ibm-902
  • cp922
  • KOI8-U
  • ibm-4909
  • windows-1250
  • windows-1251
  • windows-1252
  • windows-1253
  • windows-1254
  • windows-1255
  • windows-1256
  • windows-1257
  • windows-1258
  • macintosh
  • x-mac-greek
  • x-mac-cyrillic
  • x-mac-centraleurroman
  • x-mac-turkish
  • hp-roman8
  • Adobe-Standard-Encoding
  • cp1006
  • cp1098
  • cp1124
  • cp1125
  • ibm-1129
  • cp1131
  • ibm-1133
  • ISO-2022-JP
  • JIS_Encoding
  • ISO-2022-JP-2
  • ISO_2022,locale=ja,version=3
  • ISO_2022,locale=ja,version=4
  • ISO-2022-KR
  • ISO_2022,locale=ko,version=1
  • ISO-2022-CN
  • ISO-2022-CN-EXT
  • HZ-GB-2312
  • windows-57002
  • windows-57003
  • windows-57011
  • windows-57010
  • windows-57007
  • windows-57004
  • windows-57005
  • windows-57008
  • windows-57009
  • LMBCS-1
  • LMBCS-2
  • LMBCS-3
  • LMBCS-4
  • LMBCS-5
  • LMBCS-6
  • LMBCS-8
  • LMBCS-11
  • LMBCS-16
  • LMBCS-17
  • LMBCS-18
  • LMBCS-19
  • IBM037
  • ebcdic-de
  • ebcdic-dk
  • IBM278
  • IBM280
  • IBM284
  • IBM285
  • IBM290
  • IBM297
  • IBM420
  • IBM424
  • IBM500
  • ibm-803
  • IBM-Thai
  • IBM870
  • IBM871
  • cp875
  • IBM918
  • cp930
  • cp933
  • cp935
  • cp937
  • cp939
  • cp1025
  • IBM1026
  • IBM1047
  • cp1097
  • cp1112
  • cp1122
  • cp1123
  • ibm-1130
  • ibm-1132
  • ibm-1137
  • IBM01140
  • IBM01141
  • IBM01142
  • IBM01143
  • IBM01144
  • IBM01145
  • IBM01146
  • IBM01147
  • IBM01148
  • IBM01149
  • ibm-1153
  • ibm-1154
  • ibm-1155
  • ibm-1156
  • ibm-1157
  • ibm-1158
  • ibm-1160
  • ibm-1164
  • ibm-1364
  • ibm-1371
  • ibm-1388
  • ibm-1390
  • ibm-1399
  • ibm-5123
  • ibm-8482
  • ibm-16684
  • ibm-4899
  • ibm-4971
  • ebcdic-he
  • ebcdic-ar
  • ibm-37_P100-1995,swaplfnl
  • ibm-1047_P100-1995,swaplfnl
  • ibm-1140_P100-1997,swaplfnl
  • ibm-1142_P100-1997,swaplfnl
  • ibm-1143_P100-1997,swaplfnl
  • ibm-1144_P100-1997,swaplfnl
  • ibm-1145_P100-1997,swaplfnl
  • ibm-1146_P100-1997,swaplfnl
  • ibm-1147_P100-1997,swaplfnl
  • ibm-1148_P100-1997,swaplfnl
  • ibm-1149_P100-1997,swaplfnl
  • ibm-1153_P100-1999,swaplfnl
  • ibm-12712_P100-1998,swaplfnl
  • ibm-16804_X110-1999,swaplfnl
  • ebcdic-xml-us

<SeparadorLinea> (opcional)

Tipo: String.
Se establece una línea que se utiliza como separador de línea; el símbolo LF se generará a partir de este separador durante la lectura del archivo.
Si la línea está vacía, entonces los separadores de línea no se convierten al leer.
Algunos ejemplos de delimitadores de cadena válidos:

  • CR;
  • LF;
  • CR + LF (el valor predeterminado, se puede omitir).

Si se utilizan otras cadenas como delimitadores de cadena, se generará una excepción.
Valor predeterminado: CR + LF.

Descripción de la variante del método:

Lee un documento de texto desde un archivo.

Variante de sintaxis: Desde un flujo

Sintaxis:

Leer(<Flujo>, <TipoArchivo>, <SeparadorLinea>)

Parámetros:

<Flujo> (obligatorio)

Tipo: Stream, MemoryStream, FileStream.
Flujo para la lectura.

<TipoArchivo> (opcional)

Tipo: TextEncoding, String.
Especifica la codificación de texto en un archivo. Si se especifica un tipo para el archivo abierto, se leerá de acuerdo a ese tipo. Se generará una excepción si el formato real del archivo no coincide con el tipo especificado.
Si no se especifica el formato del archivo, se leerá como un archivo en formato UTF8, UTF16 o ANSI. Se generará una excepción si el archivo no se puede leer en ninguno de estos formatos.

El tipo de archivo se puede establecer tanto como el valor de la enumeración TextEncoding como como una cadena que indica el nombre de la codificación.
Nombres de codificaciones admitidos:

  • UTF-8
  • UTF-16
  • UTF-16BE
  • UTF-16LE
  • UTF-32
  • UTF-32BE
  • UTF-32LE
  • UTF16_PlatformEndian
  • UTF16_OppositeEndian
  • UTF32_PlatformEndian
  • UTF32_OppositeEndian
  • UTF-7
  • IMAP-mailbox-name
  • SCSU
  • BOCU-1
  • CESU-8
  • ISO-8859-1
  • US-ASCII
  • gb18030
  • IBM367
  • iso-8859-2
  • iso-8859-3
  • iso-8859-4
  • iso-8859-5
  • iso-8859-6
  • iso-8859-7
  • iso-8859-8
  • iso-8859-9
  • iso-8859-13
  • iso-8859-15
  • cp932
  • Shift_JIS
  • EUC-JP
  • cp33722
  • windows-950
  • Big5
  • cp950
  • Big5-HKSCS
  • cp1386
  • GBK
  • GB2312
  • GB_2312-80
  • cp964
  • cp949
  • cp949c
  • EUC-KR
  • ibm-971
  • KSC_5601
  • ibm-1363
  • windows-949
  • windows-874
  • cp874
  • ibm-1162
  • cp437
  • cp737
  • cp775
  • cp850
  • cp851
  • cp852
  • cp855
  • cp856
  • cp857
  • cp858
  • cp860
  • cp861
  • cp862
  • cp863
  • cp864
  • cp865
  • cp866
  • ibm-867
  • CP868
  • cp869
  • KOI8-R
  • ibm-901
  • ibm-902
  • cp922
  • KOI8-U
  • ibm-4909
  • windows-1250
  • windows-1251
  • windows-1252
  • windows-1253
  • windows-1254
  • windows-1255
  • windows-1256
  • windows-1257
  • windows-1258
  • macintosh
  • x-mac-greek
  • x-mac-cyrillic
  • x-mac-centraleurroman
  • x-mac-turkish
  • hp-roman8
  • Adobe-Standard-Encoding
  • cp1006
  • cp1098
  • cp1124
  • cp1125
  • ibm-1129
  • cp1131
  • ibm-1133
  • ISO-2022-JP
  • JIS_Encoding
  • ISO-2022-JP-2
  • ISO_2022,locale=ja,version=3
  • ISO_2022,locale=ja,version=4
  • ISO-2022-KR
  • ISO_2022,locale=ko,version=1
  • ISO-2022-CN
  • ISO-2022-CN-EXT
  • HZ-GB-2312
  • windows-57002
  • windows-57003
  • windows-57011
  • windows-57010
  • windows-57007
  • windows-57004
  • windows-57005
  • windows-57008
  • windows-57009
  • LMBCS-1
  • LMBCS-2
  • LMBCS-3
  • LMBCS-4
  • LMBCS-5
  • LMBCS-6
  • LMBCS-8
  • LMBCS-11
  • LMBCS-16
  • LMBCS-17
  • LMBCS-18
  • LMBCS-19
  • IBM037
  • ebcdic-de
  • ebcdic-dk
  • IBM278
  • IBM280
  • IBM284
  • IBM285
  • IBM290
  • IBM297
  • IBM420
  • IBM424
  • IBM500
  • ibm-803
  • IBM-Thai
  • IBM870
  • IBM871
  • cp875
  • IBM918
  • cp930
  • cp933
  • cp935
  • cp937
  • cp939
  • cp1025
  • IBM1026
  • IBM1047
  • cp1097
  • cp1112
  • cp1122
  • cp1123
  • ibm-1130
  • ibm-1132
  • ibm-1137
  • IBM01140
  • IBM01141
  • IBM01142
  • IBM01143
  • IBM01144
  • IBM01145
  • IBM01146
  • IBM01147
  • IBM01148
  • IBM01149
  • ibm-1153
  • ibm-1154
  • ibm-1155
  • ibm-1156
  • ibm-1157
  • ibm-1158
  • ibm-1160
  • ibm-1164
  • ibm-1364
  • ibm-1371
  • ibm-1388
  • ibm-1390
  • ibm-1399
  • ibm-5123
  • ibm-8482
  • ibm-16684
  • ibm-4899
  • ibm-4971
  • ebcdic-he
  • ebcdic-ar
  • ibm-37_P100-1995,swaplfnl
  • ibm-1047_P100-1995,swaplfnl
  • ibm-1140_P100-1997,swaplfnl
  • ibm-1142_P100-1997,swaplfnl
  • ibm-1143_P100-1997,swaplfnl
  • ibm-1144_P100-1997,swaplfnl
  • ibm-1145_P100-1997,swaplfnl
  • ibm-1146_P100-1997,swaplfnl
  • ibm-1147_P100-1997,swaplfnl
  • ibm-1148_P100-1997,swaplfnl
  • ibm-1149_P100-1997,swaplfnl
  • ibm-1153_P100-1999,swaplfnl
  • ibm-12712_P100-1998,swaplfnl
  • ibm-16804_X110-1999,swaplfnl
  • ebcdic-xml-us

<SeparadorLinea> (opcional)

Tipo: String.
Se establece una línea que se utiliza como separador de línea; el símbolo LF se generará a partir de este separador durante la lectura del archivo.
Si la línea está vacía, entonces los separadores de línea no se convierten al leer.
Algunos ejemplos de delimitadores de cadena válidos:

  • CR;
  • LF;
  • CR + LF (el valor predeterminado, se puede omitir).

Si se utilizan otras cadenas como delimitadores de cadena, se generará una excepción.
Valor predeterminado: CR + LF.

Descripción:

Lee un documento de texto desde un archivo.

Disponibilidad:

Cliente ligero, servidor, cliente grueso, conexión externa.

Ejemplo:

// Variante 1

DocTexto.Leer(“catalogo.txt”);

// Variante 2

DocTexto.Leer(“catalogo.txt”,“cp866”);

Véase también:

TextDocument, método BeginReading
TextDocument, método ReadAsync

Disponible desde:

Disponible desde la versión 8.0.

Descripción cambiada en la versión 8.3.18.