TarWriter.WriteEntryAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
WriteEntryAsync(TarEntry, CancellationToken) |
Escribe de forma asincrónica la entrada especificada en la secuencia de archivo. |
WriteEntryAsync(String, String, CancellationToken) |
Escribe de forma asincrónica el archivo especificado en la secuencia de archivo como una entrada tar. |
WriteEntryAsync(TarEntry, CancellationToken)
- Source:
- TarWriter.cs
- Source:
- TarWriter.cs
- Source:
- TarWriter.cs
Escribe de forma asincrónica la entrada especificada en la secuencia de archivo.
public System.Threading.Tasks.Task WriteEntryAsync (System.Formats.Tar.TarEntry entry, System.Threading.CancellationToken cancellationToken = default);
member this.WriteEntryAsync : System.Formats.Tar.TarEntry * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As Task
Parámetros
- entry
- TarEntry
Entrada tar que se va a escribir.
- cancellationToken
- CancellationToken
Token para supervisar solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
Excepciones
El tipo de entrada es HardLink o SymbolicLink y es LinkName o está null
vacío.
La secuencia de archivo se elimina.
entry
es null
.
Se ha producido un problema de E/S.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Antes de escribir una entrada en el archivo, si escribió datos en la entrada de DataStream, asegúrese de rebobinarla en la posición inicial deseada.
Estos son los tipos de entrada admitidos para escribir en cada formato:
V7:
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteEntry(TarEntry).
Se aplica a
WriteEntryAsync(String, String, CancellationToken)
- Source:
- TarWriter.cs
- Source:
- TarWriter.cs
- Source:
- TarWriter.cs
Escribe de forma asincrónica el archivo especificado en la secuencia de archivo como una entrada tar.
public System.Threading.Tasks.Task WriteEntryAsync (string fileName, string? entryName, System.Threading.CancellationToken cancellationToken = default);
member this.WriteEntryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task
Parámetros
- fileName
- String
Ruta de acceso al archivo que se va a escribir en el archivo.
- entryName
- String
El nombre del archivo como debe representarse en el archivo. Debe incluir la ruta de acceso relativa opcional y el nombre de archivo.
- cancellationToken
- CancellationToken
Token para supervisar solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
Excepciones
La secuencia de archivo se elimina.
El valor de fileName
o entryName
es null
o está vacío.
Se ha producido un problema de E/S.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteEntry(String, String).