DkmFileTransferStream Classe

Definição

Representa um fluxo de arquivos que pode ser usado para transferir um arquivo grande pela conexão do depurador remoto.

public ref class DkmFileTransferStream : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("cfeabf40-7ab2-7d44-c16d-ef23d4579e8c")]
public class DkmFileTransferStream : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("cfeabf40-7ab2-7d44-c16d-ef23d4579e8c")>]
type DkmFileTransferStream = class
    inherit DkmDataContainer
    interface IDisposable
Public Class DkmFileTransferStream
Inherits DkmDataContainer
Implements IDisposable
Herança
DkmFileTransferStream
Atributos
Implementações

Propriedades

Connection

Conexão de transporte sobre a qual o arquivo será transferido.

IsUnloaded

Retornará true se um evento ' Unloaded ' tiver sido gerado para este objeto (exemplo: DkmThread:: Unload é chamado) ou se o objeto foi fechado. Observe que o cuidado deve ser usado ao verificar esse status como, sem sincronização, o status retornado pode não ser mais preciso na instrução após sua leitura.

(Herdado de DkmDataContainer)
RemoteFilePath

Caminho para o arquivo que está sendo transferido. As variáveis de ambiente serão expandidas (por exemplo:% TMP% \deploy.txt). O caminho deve ser um caminho completo para o arquivo.

UniqueId

GUID que identifica exclusivamente este objeto.

Métodos

Close()

Fecha o objeto de transferência de arquivo. Isso fechará o identificador de arquivo subjacente se ele ainda não estiver fechado porque todos os bytes foram transferidos. Esse método deve ser chamado pelo componente que criou o objeto de transferência de arquivo de arquivo.

Os objetos DkmFileTransferStream são fechados automaticamente quando seu objeto DkmTransportConnection associado é fechado.

Esse método só pode ser chamado pelo componente que criou o objeto.

Create(DkmTransportConnection, String, DkmDataItem)

Cria um novo objeto de fluxo de transferência de arquivo que é usado para representar um arquivo que está sendo transmitido pela rede. Observe que o arquivo não é aberto imediatamente quando o objeto é criado. O chamador deve fechar o objeto de transferência de arquivo quando terminar. O chamador é responsável por fechar o objeto criado depois que eles são concluídos.

GetDataItem<T>()

Obtém a instância de ' T' que foi adicionada a esta instância de contêiner. Se esse contêiner não contiver um ' T', essa função retornará NULL.

(Herdado de DkmDataContainer)
ReadFirst(Byte[], Int32, UInt64, UInt64)

Inicia uma operação de leitura de arquivo remoto. O arquivo remoto será aberto e os bytes até o tamanho do buffer de conteúdo serão transferidos. Se o arquivo for muito grande para se ajustar ao buffer de conteúdo, o ReadNext poderá ser chamado para ler os bytes restantes.

ReadFirst(UInt64, Byte[], Int32, UInt64, UInt64)

Inicia uma operação de leitura de arquivo remoto. O arquivo remoto será aberto e os bytes até o tamanho do buffer de conteúdo serão transferidos. Se o arquivo for muito grande para se ajustar ao buffer de conteúdo, o ReadNext poderá ser chamado para ler os bytes restantes.

Essa API foi introduzida no Visual Studio 15 atualização 6 (DkmApiVersion. VS15Update6).

ReadFirst(UInt64, Void*, Int32, Int32, UInt64, UInt64)

Inicia uma operação de leitura de arquivo remoto. O arquivo remoto será aberto e os bytes até o tamanho do buffer de conteúdo serão transferidos. Se o arquivo for muito grande para se ajustar ao buffer de conteúdo, o ReadNext poderá ser chamado para ler os bytes restantes.

Essa API foi introduzida no Visual Studio 15 atualização 6 (DkmApiVersion. VS15Update6).

ReadFirst(Void*, Int32, Int32, UInt64, UInt64)

Inicia uma operação de leitura de arquivo remoto. O arquivo remoto será aberto e os bytes até o tamanho do buffer de conteúdo serão transferidos. Se o arquivo for muito grande para se ajustar ao buffer de conteúdo, o ReadNext poderá ser chamado para ler os bytes restantes.

ReadNext(Byte[], Int32)

Lê o próximo conjunto de bytes do arquivo remoto. Essa API falhará se ReadFirst ainda não tiver sido chamado no DkmFileTransferStream.

ReadNext(Void*, Int32, Int32)

Lê o próximo conjunto de bytes do arquivo remoto. Essa API falhará se ReadFirst ainda não tiver sido chamado no DkmFileTransferStream.

RemoveDataItem<T>()

Remova a instância de ' T' deste contêiner. Normalmente, é desnecessário chamar esse método, pois um contêiner de dados será automaticamente esvaziado quando o objeto for fechado.

(Herdado de DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Coloque um novo item no contêiner de dados.

(Herdado de DkmDataContainer)
WriteFirst(Byte[], UInt64, UInt64, Boolean)

Inicia uma operação de gravação de arquivo remoto. O arquivo remoto será aberto e os bytes do conteúdo serão gravados nele. Se bytes adicionais além do que estiver no conteúdo devem ser transferidos, WriteNext deverá ser chamado para transferi-los. Se o diretório desse arquivo não existir, o depurador tentará criá-lo.

WriteNext(Byte[])

Grava o próximo conjunto de bytes no arquivo remoto. Essa API falhará se WriteFirst ainda não tiver sido chamado no DkmFileTransferStream.

Implantações explícitas de interface

IDisposable.Dispose()

Aplica-se a