DkmFileTransferStream Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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() |