Share via


StorageStreamDownloader Classe

Um objeto de transmissão em fluxo a transferir do Armazenamento do Azure.

Herança
StorageStreamDownloader

Construtor

StorageStreamDownloader(clients=None, config=None, start_range=None, end_range=None, validate_content=None, encryption_options=None, max_concurrency=1, name=None, container=None, encoding=None, download_cls=None, **kwargs)

Parâmetros

Name Description
clients
valor predefinido: None
config
valor predefinido: None
start_range
valor predefinido: None
end_range
valor predefinido: None
validate_content
valor predefinido: None
encryption_options
valor predefinido: None
max_concurrency
valor predefinido: 1
name
valor predefinido: None
container
valor predefinido: None
encoding
valor predefinido: None
download_cls
valor predefinido: None

Variáveis

Name Description
name
str

O nome do blob a ser transferido.

container
str

O nome do contentor onde se encontra o blob.

properties

As propriedades do blob a ser transferido. Se apenas um intervalo dos dados estiver a ser transferido, isso será refletido nas propriedades.

size
int

O tamanho do total de dados no fluxo. Este será o intervalo de bytes, se especificado, caso contrário, o tamanho total do blob.

Métodos

chunks

Iterar sobre segmentos no fluxo de transferência.

content_as_bytes

PRETERIDO: transfira o conteúdo deste ficheiro.

Esta operação está a bloquear até que todos os dados sejam transferidos.

Este método foi preterido, utilize func:readall .

content_as_text

PRETERIDO: transfira os conteúdos deste blob e descodifica-o como texto.

Esta operação está a bloquear até que todos os dados sejam transferidos.

Este método foi preterido, utilize func:readall .

download_to_stream

PRETERIDO: transfira o conteúdo deste blob para um fluxo.

Este método foi preterido, utilize func:readinto .

read

Leia até dimensionar bytes do fluxo e devolva-os. Se o tamanho não for especificado ou for -1, todos os bytes serão lidos.

readall

Leia todo o conteúdo deste blob. Esta operação está a bloquear até que todos os dados sejam transferidos.

readinto

Transfira o conteúdo deste blob para um fluxo.

chunks

Iterar sobre segmentos no fluxo de transferência.

chunks() -> AsyncIterator[bytes]

Devoluções

Tipo Description

Um iterador assíncrono dos segmentos no fluxo de transferência.

content_as_bytes

PRETERIDO: transfira o conteúdo deste ficheiro.

Esta operação está a bloquear até que todos os dados sejam transferidos.

Este método foi preterido, utilize func:readall .

async content_as_bytes(max_concurrency=1)

Parâmetros

Name Description
max_concurrency
int

O número de ligações paralelas para transferir.

valor predefinido: 1

Devoluções

Tipo Description

O conteúdo do ficheiro como bytes.

content_as_text

PRETERIDO: transfira os conteúdos deste blob e descodifica-o como texto.

Esta operação está a bloquear até que todos os dados sejam transferidos.

Este método foi preterido, utilize func:readall .

async content_as_text(max_concurrency=1, encoding='UTF-8')

Parâmetros

Name Description
max_concurrency
int

O número de ligações paralelas para transferir.

valor predefinido: 1
encoding
str

Teste a codificação para descodificar os bytes transferidos. A predefinição é UTF-8.

valor predefinido: UTF-8

Devoluções

Tipo Description
str

O conteúdo do ficheiro como um str.

download_to_stream

PRETERIDO: transfira o conteúdo deste blob para um fluxo.

Este método foi preterido, utilize func:readinto .

async download_to_stream(stream, max_concurrency=1)

Parâmetros

Name Description
stream
Necessário
IO[<xref:T>]

O fluxo para o que pretende transferir. Pode ser uma alça de ficheiro aberta ou qualquer fluxo gravável. O fluxo tem de ser procurado se a transferência utilizar mais do que uma ligação paralela.

max_concurrency
int

O número de ligações paralelas para transferir.

valor predefinido: 1

Devoluções

Tipo Description
Any

As propriedades do blob transferido.

read

Leia até dimensionar bytes do fluxo e devolva-os. Se o tamanho não for especificado ou for -1, todos os bytes serão lidos.

async read(size: int | None = -1) -> T

Parâmetros

Name Description
size

O número de bytes a transferir a partir do fluxo. Deixe não especificado ou definido como -1 para transferir todos os bytes.

valor predefinido: -1

Devoluções

Tipo Description
<xref:T>

Os dados pedidos como bytes ou uma cadeia se a codificação tiver sido especificada. Se o valor devolvido estiver vazio, não existem mais dados para ler.

readall

Leia todo o conteúdo deste blob. Esta operação está a bloquear até que todos os dados sejam transferidos.

async readall() -> T

Devoluções

Tipo Description
<xref:T>

Os dados pedidos como bytes ou uma cadeia se a codificação tiver sido especificada.

readinto

Transfira o conteúdo deste blob para um fluxo.

async readinto(stream: IO[bytes]) -> int

Parâmetros

Name Description
stream
Necessário

O fluxo para o que pretende transferir. Pode ser uma alça de ficheiro aberta ou qualquer fluxo gravável. O fluxo tem de ser procurado se a transferência utilizar mais do que uma ligação paralela.

Devoluções

Tipo Description
int

O número de bytes lidos.