Compartir a través de


ShareFileClient Clase

Definición

ShareFileClient permite manipular archivos de Azure Storage.

public class ShareFileClient
type ShareFileClient = class
Public Class ShareFileClient
Herencia
ShareFileClient

Constructores

ShareFileClient()

Inicializa una nueva instancia de la ShareFileClient clase para simular.

ShareFileClient(String, String, String)

Inicializa una nueva instancia de la clase ShareFileClient.

ShareFileClient(String, String, String, ShareClientOptions)

Inicializa una nueva instancia de la clase ShareFileClient.

ShareFileClient(Uri, AzureSasCredential, ShareClientOptions)

Inicializa una nueva instancia de la clase ShareFileClient.

ShareFileClient(Uri, ShareClientOptions)

Inicializa una nueva instancia de la clase ShareFileClient.

ShareFileClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inicializa una nueva instancia de la clase ShareFileClient.

ShareFileClient(Uri, TokenCredential, ShareClientOptions)

Inicializa una nueva instancia de la clase ShareFileClient.

Tenga en cuenta que ShareTokenIntent actualmente es necesario para la autenticación de tokens.

Propiedades

AccountName

Obtiene el nombre de la cuenta de almacenamiento correspondiente al cliente de archivos.

CanGenerateSasUri

Determina si el cliente puede generar una SAS. Si el cliente se autentica con un StorageSharedKeyCredential.

Name

Obtiene el nombre del archivo.

Path

Obtiene la ruta de acceso del archivo.

ShareName

Obtiene el nombre del recurso compartido correspondiente al cliente de archivos.

Uri

Obtiene el punto de conexión principal Uri del directorio.

Métodos

AbortCopy(String, ShareFileRequestConditions, CancellationToken)

Intenta cancelar una copia pendiente iniciada anteriormente y deja un archivo de destino con una longitud cero y metadatos completos.

Para obtener más información, vea Anule el archivo de copia.

AbortCopyAsync(String, ShareFileRequestConditions, CancellationToken)

Intenta cancelar una copia pendiente iniciada anteriormente y deja un archivo de destino con una longitud cero y metadatos completos.

Para obtener más información, vea Anule el archivo de copia.

ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken)

La ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken) operación borra el range de un archivo.

Para obtener más información, vea Put Range.

ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken)

La ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken) operación borra el range de un archivo.

Para obtener más información, vea Put Range.

Create(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Crea un nuevo archivo o reemplaza un archivo existente.

Para obtener más información, vea Crear archivo.

CreateAsync(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Crea un nuevo archivo o reemplaza un archivo existente.

Para obtener más información, vea Crear archivo.

Delete(ShareFileRequestConditions, CancellationToken)

La operación Delete(ShareFileRequestConditions, CancellationToken) quita inmediatamente el archivo de la cuenta de almacenamiento.

Para obtener más información, vea Eliminar archivo.

DeleteAsync(ShareFileRequestConditions, CancellationToken)

La operación DeleteAsync(ShareFileRequestConditions, CancellationToken) quita inmediatamente el archivo de la cuenta de almacenamiento.

Para obtener más información, vea Eliminar archivo.

DeleteIfExists(ShareFileRequestConditions, CancellationToken)

La DeleteIfExists(ShareFileRequestConditions, CancellationToken) operación quita inmediatamente el archivo de la cuenta de almacenamiento, si existe.

Para obtener más información, vea Eliminar archivo.

DeleteIfExistsAsync(ShareFileRequestConditions, CancellationToken)

La DeleteIfExists(ShareFileRequestConditions, CancellationToken) operación quita inmediatamente el archivo de la cuenta de almacenamiento, si existe.

Para obtener más información, vea Eliminar archivo.

Download(ShareFileDownloadOptions, CancellationToken)

La operación Download(ShareFileDownloadOptions, CancellationToken) lee o descarga un archivo del sistema, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener archivo.

DownloadAsync(ShareFileDownloadOptions, CancellationToken)

La operación DownloadAsync(ShareFileDownloadOptions, CancellationToken) lee o descarga un archivo del sistema, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener archivo.

Exists(CancellationToken)

Se Exists(CancellationToken) puede llamar a la operación en para ShareFileClient ver si el archivo asociado existe en el recurso compartido de la cuenta de almacenamiento.

ExistsAsync(CancellationToken)

Se Exists(CancellationToken) puede llamar a la operación en para ShareFileClient ver si el archivo asociado existe en el recurso compartido de la cuenta de almacenamiento.

ForceCloseAllHandles(CancellationToken)

La ForceCloseAllHandles(CancellationToken) operación cierra todos los identificadores abiertos en un archivo en el servicio.

Esta API está pensada para usarse junto con GetHandlesAsync(CancellationToken) para forzar los identificadores de cierre que bloquean las operaciones. Estos identificadores pueden haber filtrado o perdido el seguimiento de los clientes SMB. La API tiene un impacto del lado cliente en el identificador que se está cerrando, incluidos los errores visibles del usuario debido a intentos erróneos de lectura o escritura de archivos. Esta API no está pensada para su uso como reemplazo o alternativa para cerrar SMB.

Para obtener más información, vea Forzar asas de cierre.

ForceCloseAllHandlesAsync(CancellationToken)

La ForceCloseAllHandlesAsync(CancellationToken) operación cierra todos los identificadores abiertos en un archivo en el servicio.

Esta API está pensada para usarse junto con GetHandlesAsync(CancellationToken) para forzar los identificadores de cierre que bloquean las operaciones. Estos identificadores pueden haber filtrado o perdido el seguimiento de los clientes SMB. La API tiene un impacto del lado cliente en el identificador que se está cerrando, incluidos los errores visibles del usuario debido a intentos erróneos de lectura o escritura de archivos. Esta API no está pensada para su uso como reemplazo o alternativa para cerrar SMB.

Para obtener más información, vea Forzar asas de cierre.

ForceCloseHandle(String, CancellationToken)

La ForceCloseHandle(String, CancellationToken) operación cierra un identificador abierto en un archivo en el servicio. Admite el cierre de un único identificador especificado por handleId.

Esta API está pensada para usarse junto con GetHandlesAsync(CancellationToken) para forzar los identificadores de cierre que bloquean las operaciones. Estos identificadores pueden haber filtrado o perdido el seguimiento de los clientes SMB. La API tiene un impacto del lado cliente en el identificador que se está cerrando, incluidos los errores visibles del usuario debido a intentos erróneos de lectura o escritura de archivos. Esta API no está pensada para su uso como reemplazo o alternativa para cerrar SMB.

Para obtener más información, vea Forzar asas de cierre.

ForceCloseHandleAsync(String, CancellationToken)

La ForceCloseHandleAsync(String, CancellationToken) operación cierra un identificador abierto en un archivo en el servicio. Admite el cierre de un único identificador especificado por handleId.

Esta API está pensada para usarse junto con GetHandlesAsync(CancellationToken) para forzar los identificadores de cierre que bloquean las operaciones. Estos identificadores pueden haber filtrado o perdido el seguimiento de los clientes SMB. La API tiene un impacto del lado cliente en el identificador que se está cerrando, incluidos los errores visibles del usuario debido a intentos erróneos de lectura o escritura de archivos. Esta API no está pensada para su uso como reemplazo o alternativa para cerrar SMB.

Para obtener más información, vea Forzar asas de cierre.

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) devuelve un Uri valor de tipo que genera un URI de firma de acceso compartido (SAS) del servicio de archivos compartidos en función de las propiedades y parámetros del cliente pasados. La SAS está firmada por la credencial de clave compartida del cliente.

Para comprobar si el cliente puede firmar una sas de servicio, consulte CanGenerateSasUri.

Para obtener más información, vea Construcción de una SAS de servicio.

GenerateSasUri(ShareSasBuilder)

GenerateSasUri(ShareSasBuilder) devuelve un Uri valor de tipo que genera un URI de firma de acceso compartido (SAS) del servicio de archivos compartidos basado en las propiedades y el generador del cliente. La SAS está firmada por la credencial de clave compartida del cliente.

Para comprobar si el cliente puede firmar una sas de servicio, consulte CanGenerateSasUri.

Para obtener más información, vea Construcción de una SAS de servicio.

GetCopyAuthorizationHeaderAsync(ShareFileClient, CancellationToken)

Obtenga un elemento ShareFileClientHttpAuthorization para pasar la autorización al realizar la copia del servicio al servicio donde OAuth es necesario para autenticar el origen.

GetHandles(CancellationToken)

La GetHandles(CancellationToken) operación devuelve una secuencia asincrónica de los identificadores abiertos en un directorio o un archivo. La enumeración de los identificadores puede realizar varias solicitudes al servicio al capturar todos los valores.

Para obtener más información, vea Identificadores de lista.

GetHandlesAsync(CancellationToken)

La GetHandlesAsync(CancellationToken) operación devuelve una secuencia asincrónica de los identificadores abiertos en un directorio o un archivo. La enumeración de los identificadores puede realizar varias solicitudes al servicio al capturar todos los valores.

Para obtener más información, vea Identificadores de lista.

GetParentShareClientCore()

Cree un nuevo ShareClient que apunte a este ShareFileClientcontenedor primario. El nuevo ShareClient usa la misma canalización de directiva de solicitud que .ShareFileClient

GetParentShareDirectoryClientCore()

Cree un nuevo ShareDirectoryClient que apunte a este ShareFileClientcontenedor primario. El nuevo ShareDirectoryClient usa la misma canalización de directiva de solicitud que .ShareFileClient

GetProperties(ShareFileRequestConditions, CancellationToken)

La operación GetProperties(ShareFileRequestConditions, CancellationToken) devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el archivo. No devuelve el contenido del archivo.

Para obtener más información, vea Obtiene las propiedades del archivo.

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)

La operación GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el archivo. No devuelve el contenido del archivo.

Para obtener más información, vea Obtiene las propiedades del archivo.

GetRangeList(ShareFileGetRangeListOptions, CancellationToken)

Devuelve la lista de intervalos válidos para un archivo.

Para obtener más información, vea Rangos de lista.

GetRangeListAsync(ShareFileGetRangeListOptions, CancellationToken)

Devuelve la lista de intervalos válidos para un archivo.

Para obtener más información, vea Rangos de lista.

GetRangeListDiff(ShareFileGetRangeListDiffOptions, CancellationToken)

Devuelve la lista de intervalos que han cambiado en el archivo desde que se tomó previousSnapshot.

Para obtener más información, vea Rangos de lista.

GetRangeListDiffAsync(ShareFileGetRangeListDiffOptions, CancellationToken)

Devuelve la lista de intervalos que han cambiado en el archivo desde que se tomó previousSnapshot.

Para obtener más información, vea Rangos de lista.

OpenRead(ShareFileOpenReadOptions, CancellationToken)

Abre un flujo para leer del archivo. La secuencia solo descargará el archivo a medida que se lee la secuencia.

OpenReadAsync(ShareFileOpenReadOptions, CancellationToken)

Abre un flujo para leer del archivo. La secuencia solo descargará el archivo a medida que se lee la secuencia.

OpenWrite(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Abre un flujo para escribir en el archivo.

OpenWriteAsync(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Abre un flujo para escribir en el archivo.

Rename(String, ShareFileRenameOptions, CancellationToken)

Cambia el nombre de un archivo. Esta API no admite cambiar el nombre de un archivo de un recurso compartido a otro o entre cuentas de almacenamiento.

RenameAsync(String, ShareFileRenameOptions, CancellationToken)

Cambia el nombre de un archivo. Esta API no admite cambiar el nombre de un archivo de un recurso compartido a otro o entre cuentas de almacenamiento.

SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

La operación SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) establece las propiedades del sistema en el archivo.

Para obtener más información, vea Establecer propiedades de archivo.

SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

La operación SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) establece las propiedades del sistema en el archivo.

Para obtener más información, vea Establecer propiedades de archivo.

SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

La SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operación establece los metadatos definidos por el usuario para el archivo especificado como uno o varios pares nombre-valor.

Para obtener más información, vea Establecer metadatos de archivo.

SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

La SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operación establece los metadatos definidos por el usuario para el archivo especificado como uno o varios pares nombre-valor.

Para obtener más información, vea Establecer metadatos de archivo.

StartCopy(Uri, ShareFileCopyOptions, CancellationToken)

Copia un blob o un archivo en un archivo de destino dentro de la cuenta de almacenamiento.

Para obtener más información, vea Copiar archivo.

StartCopyAsync(Uri, ShareFileCopyOptions, CancellationToken)

Copia un blob o un archivo en un archivo de destino dentro de la cuenta de almacenamiento.

Para obtener más información, vea Copiar archivo.

Upload(Stream, ShareFileUploadOptions, CancellationToken)

La Upload(Stream, ShareFileUploadOptions, CancellationToken) operación escribe options.Stream.Stream en un archivo.

Para obtener más información, vea Poner rango.

UploadAsync(Stream, ShareFileUploadOptions, CancellationToken)

La UploadAsync(Stream, ShareFileUploadOptions, CancellationToken) operación escribe options.Stream.Stream en un archivo.

Para obtener más información, vea Poner rango.

UploadRange(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

La Azure.Storage.Files.Shares.ShareFileClient.UploadRange(Azure.HttpRange,System.IO.Stream,System.Byte[],System.IProgress{System.Int64},Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operación escribe content en range un de un archivo .

Para obtener más información, vea Poner rango.

UploadRangeAsync(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

La Azure.Storage.Files.Shares.ShareFileClient.UploadRangeAsync(Azure.HttpRange,System.IO.Stream,System.Byte[],System.IProgress{System.Int64},Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operación escribe content en range un de un archivo .

Para obtener más información, vea Poner rango.

UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)

La UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken) operación escribe un intervalo entre un archivo de Azure y otro archivo de Azure. Esta API solo se admite para la versión 2019-02-02 y posteriores.

UploadRangeFromUriAsync(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)

La Azure.Storage.Files.Shares.ShareFileClient.UploadRangeFromUriAsync(System.Uri,Azure.HttpRange,Azure.HttpRange,Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operación escribe un intervalo entre un archivo de Azure y otro archivo de Azure. Esta API solo se admite para la versión 2019-02-02 y posteriores.

WithSnapshot(String)

Inicializa una nueva instancia de la ShareFileClient clase con un origen idéntico Uri , pero la marca de tiempo especificada shareSnapshot .

Para obtener más información, vea Recurso compartido de instantáneas.

Métodos de extensión

GetShareLeaseClient(ShareFileClient, String)

Inicializa una nueva instancia de la clase ShareLeaseClient.

GetParentShareClient(ShareFileClient)

Cree un nuevo ShareClient que apunte a este ShareFileClientcontenedor primario. El nuevo ShareClient usa la misma canalización de directiva de solicitud que .ShareFileClient

GetParentShareDirectoryClient(ShareFileClient)

Cree un nuevo ShareDirectoryClient que apunte a este ShareFileClientcontenedor primario. El nuevo ShareDirectoryClient usa la misma canalización de directiva de solicitud que .ShareFileClient

Se aplica a