DkmFileTransferStream Класс

Определение

Представляет файловый поток, который можно использовать для передачи большого файла через подключение к удаленному отладчику.

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
Наследование
DkmFileTransferStream
Атрибуты
Реализации

Свойства

Connection

Транспортное соединение, по которому будет передан файл.

IsUnloaded

Возвращает значение true, если для данного объекта было вызвано событие "выгружено" (например, вызывается метод Дкмсреад:: Unload), или значение, если объект был закрыт. Обратите внимание, что необходимо использовать осторожность при проверке этого состояния как, без синхронизации, возвращаемое состояние может больше не быть точным после считывания инструкции.

(Унаследовано от DkmDataContainer)
RemoteFilePath

Путь к переносимому файлу. Переменные среды будут развернуты (например:% TMP% \deploy.txt). Путь должен быть полным путем к файлу.

UniqueId

Идентификатор GUID, однозначно определяющий этот объект.

Методы

Close()

Закрывает объект перемещения файла. Если этот файл еще не закрыт, то он закроет его, так как все байты были переданы. Этот метод должен вызываться компонентом, создавшим объект перемещения файлового файла.

Объекты Дкмфилетрансферстреам автоматически закрываются при закрытии связанных с ними объектов Дкмтранспортконнектион.

Этот метод может вызываться только компонентом, создавшим объект.

Create(DkmTransportConnection, String, DkmDataItem)

Создает новый объект потока передачи файлов, который используется для представления файла, который передается по сети. Обратите внимание, что файл не открывается сразу же после создания объекта. Вызывающая сторона должна закрыть объект передачи файла по завершении. Вызывающий объект отвечает за закрытие созданного объекта после его завершения.

GetDataItem<T>()

Возвращает экземпляр элемента "t", который был добавлен в этот экземпляр контейнера. Если этот контейнер не содержит 'T, эта функция возвратит значение null.

(Унаследовано от DkmDataContainer)
ReadFirst(Byte[], Int32, UInt64, UInt64)

Начинает операцию чтения удаленного файла. Будет открыт удаленный файл, и будут переданы байты до размера буфера содержимого. Если файл слишком большой для размещения в буфере содержимого, Реаднекст может быть вызван для чтения оставшихся байтов.

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

Начинает операцию чтения удаленного файла. Будет открыт удаленный файл, и будут переданы байты до размера буфера содержимого. Если файл слишком большой для размещения в буфере содержимого, Реаднекст может быть вызван для чтения оставшихся байтов.

Этот API появился в Visual Studio 15 с обновлением 6 (Дкмапиверсион. VS15Update6).

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

Начинает операцию чтения удаленного файла. Будет открыт удаленный файл, и будут переданы байты до размера буфера содержимого. Если файл слишком большой для размещения в буфере содержимого, Реаднекст может быть вызван для чтения оставшихся байтов.

Этот API появился в Visual Studio 15 с обновлением 6 (Дкмапиверсион. VS15Update6).

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

Начинает операцию чтения удаленного файла. Будет открыт удаленный файл, и будут переданы байты до размера буфера содержимого. Если файл слишком большой для размещения в буфере содержимого, Реаднекст может быть вызван для чтения оставшихся байтов.

ReadNext(Byte[], Int32)

Считывает следующий набор байтов из удаленного файла. Этот API завершится ошибкой, если в Дкмфилетрансферстреам еще не вызывался Реадфирст.

ReadNext(Void*, Int32, Int32)

Считывает следующий набор байтов из удаленного файла. Этот API завершится ошибкой, если в Дкмфилетрансферстреам еще не вызывался Реадфирст.

RemoveDataItem<T>()

Удалить экземпляр из этого контейнера. Обычно нет необходимости вызывать этот метод, так как контейнер данных будет автоматически очищаться при закрытии объекта.

(Унаследовано от DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Поместите новый элемент в контейнер данных.

(Унаследовано от DkmDataContainer)
WriteFirst(Byte[], UInt64, UInt64, Boolean)

Начинает операцию записи в удаленный файл. Будет открыт удаленный файл, и в него будут записаны байты из содержимого. Если передаются дополнительные байты, кроме содержимого, то для передачи этих данных следует вызывать Вритенекст. Если каталог этого файла не существует, отладчик попытается его создать.

WriteNext(Byte[])

Записывает следующий набор байтов в удаленный файл. Этот API завершится ошибкой, если в Дкмфилетрансферстреам еще не вызывался Вритефирст.

Явные реализации интерфейса

IDisposable.Dispose()

Применяется к