TextDocument.WriteAsync

TextDocument

WriteAsync

Disponible desde la versión 8.3.18.

Variante de sintaxis: A un archivo

Sintaxis:

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

Parámetros:

<NombreArchivo> (obligatorio)

Tipo: String.
Nombre de un archivo para almacenar un texto.

<TipoArchivo> (opcional)

Tipo: TextEncoding, String.
Tipo de codificación de archivo. El tipo de archivo se puede especificar tanto como un valor de la enumeración TextEncoding como como una cadena con el nombre de codificación especificado.
Nombres de codificación 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

Valor predeterminado: UTF8.

<SeparadorLinea> (opcional)

Tipo: String.
Se especifica una cadena utilizada como separador de cadenas. Al escribir un archivo, el carácter LF se convertirá en esta cadena. Si la cadena está vacía, los separadores de cadena no se convierten al escribir.
Opciones de separador de cadena permitidas:

  • CR;
  • LF;
  • CR + LF (el valor predeterminado no es necesario).

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

Descripción de la variante del método:

Escribe un documento de texto en un archivo.

Variante de sintaxis: A un flujo

Sintaxis:

WriteAsync(<Flujo>, <TipoArchivo>, <SeparadorLinea>, <EscribirBOM>)

Parámetros:

<Flujo> (obligatorio)

Tipo: Stream, MemoryStream, FileStream.
Flujo para la escritura del documento.

<TipoArchivo> (opcional)

Tipo: TextEncoding, String.
Tipo de codificación de texto. El tipo de codificación se puede especificar tanto como un valor de la enumeración TextEncoding como como una cadena con el nombre de codificación especificado.
Nombres de codificación 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

Valor predeterminado: UTF8.

<SeparadorLinea> (opcional)

Tipo: String.
Se especifica una cadena utilizada como separador de cadenas. Al leer un archivo, se genera el carácter LF a partir de esta cadena.
Si la cadena está vacía, los separadores de cadena no se convierten al leer.
Opciones de separador de cadena permitidas:

  • CR;
  • LF;
  • CR + LF (el valor predeterminado no es necesario).

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

<EscribirBOM> (opcional)

Tipo: Boolean.
Indica si se agregará una marca de orden de bytes (BOM) al guardar un documento.
Valor predeterminado: False.

Descripción de la variante del método:

Escribe un documento de texto en un flujo.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa:

  • True si se inició el guardado utilizando la extensión del navegador y el usuario confirmó que desea obtener el archivo (el archivo se guardó).
  • False si se inició el guardado utilizando la extensión del navegador y el usuario no confirmó que desea obtener el archivo (el archivo no se guardó).
  • Undefined si se inició el guardado con la descarga del archivo utilizando las herramientas del navegador y se desconoce si se guardó el archivo.

Descripción:

Función asíncrona. Guarda el texto en el archivo con el nombre <NombreArchivo>.

Disponibilidad:

Cliente ligero, cliente web, cliente grueso.

Véase también:

TextDocument, método Write
TextDocument, método BeginWriting

Disponible desde:

Disponible desde la versión 8.3.18.