DkmFileTransferStream Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt einen Dateistream dar, der zum Übertragen einer großen Datei über die remotedebuggerverbindung verwendet werden kann.
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
- Vererbung
- Attribute
- Implementiert
Eigenschaften
| Connection |
Transport Verbindung, über die die Datei übertragen wird. |
| IsUnloaded |
Gibt "true" zurück, wenn ein "entladen"-Ereignis für dieses Objekt ausgelöst wurde (Beispiel: dkmthread:: entladen wird aufgerufen) oder wenn das Objekt geschlossen wurde. Beachten Sie, dass bei der Überprüfung dieses Status, ohne Synchronisierung, der Status "zurückgegeben" möglicherweise nicht mehr genau der Anweisung entspricht, nachdem er gelesen wurde. (Geerbt von DkmDataContainer) |
| RemoteFilePath |
Der Pfad zu der Datei, die übertragen wird. Umgebungsvariablen werden erweitert (z.:% tmp% \deploy.txt). Der Pfad muss ein vollständiger Pfad zur Datei sein. |
| UniqueId |
GUID, die dieses Objekt eindeutig identifiziert. |
Methoden
| Close() |
Schließt das Datei Übertragungs Objekt. Dadurch wird das zugrunde liegende Datei Handle geschlossen, wenn es nicht bereits geschlossen ist, da alle Bytes übertragen wurden. Diese Methode muss von der Komponente aufgerufen werden, die das Datei Datei-Übertragungs Objekt erstellt hat. Dkmfiletransferstream-Objekte werden automatisch geschlossen, wenn das zugehörige dkmtransportconnection-Objekt geschlossen wird. Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat. |
| Create(DkmTransportConnection, String, DkmDataItem) |
Erstellt ein neues Datei Übertragungsdaten Strom-Objekt, das verwendet wird, um eine Datei darzustellen, die über das Netzwerk gestreamt wird. Beachten Sie, dass die Datei nicht sofort geöffnet wird, wenn das Objekt erstellt wird. Der Aufrufer sollte das Datei Übertragungs Objekt beenden, wenn er abgeschlossen ist. Der Aufrufer ist dafür verantwortlich, das erstellte Objekt zu schließen, nachdem es abgeschlossen wurde. |
| GetDataItem<T>() |
Ruft die Instanz von 't ' ab, die dieser Container Instanz hinzugefügt wurde. Wenn dieser Container kein 't-Zeichen enthält, gibt diese Funktion NULL zurück. (Geerbt von DkmDataContainer) |
| ReadFirst(Byte[], Int32, UInt64, UInt64) |
Startet einen Remote Datei Lesevorgang. Die Remote Datei wird geöffnet, und Bytes bis zur Größe des Inhalts Puffers werden übertragen. Wenn die Datei zu groß ist, um in den Inhalts Puffer zu passen, kann als "infonext" aufgerufen werden, um die verbleibenden Bytes zu lesen. |
| ReadFirst(UInt64, Byte[], Int32, UInt64, UInt64) |
Startet einen Remote Datei Lesevorgang. Die Remote Datei wird geöffnet, und Bytes bis zur Größe des Inhalts Puffers werden übertragen. Wenn die Datei zu groß ist, um in den Inhalts Puffer zu passen, kann als "infonext" aufgerufen werden, um die verbleibenden Bytes zu lesen. Diese API wurde in Visual Studio 15 Update 6 (dkmapiversion. VS15Update6) eingeführt. |
| ReadFirst(UInt64, Void*, Int32, Int32, UInt64, UInt64) |
Startet einen Remote Datei Lesevorgang. Die Remote Datei wird geöffnet, und Bytes bis zur Größe des Inhalts Puffers werden übertragen. Wenn die Datei zu groß ist, um in den Inhalts Puffer zu passen, kann als "infonext" aufgerufen werden, um die verbleibenden Bytes zu lesen. Diese API wurde in Visual Studio 15 Update 6 (dkmapiversion. VS15Update6) eingeführt. |
| ReadFirst(Void*, Int32, Int32, UInt64, UInt64) |
Startet einen Remote Datei Lesevorgang. Die Remote Datei wird geöffnet, und Bytes bis zur Größe des Inhalts Puffers werden übertragen. Wenn die Datei zu groß ist, um in den Inhalts Puffer zu passen, kann als "infonext" aufgerufen werden, um die verbleibenden Bytes zu lesen. |
| ReadNext(Byte[], Int32) |
Liest den nächsten Satz von Bytes aus der Remote Datei. Diese API schlägt fehl, wenn "Read First" nicht bereits für "dkmfiletransferstream" aufgerufen wurde. |
| ReadNext(Void*, Int32, Int32) |
Liest den nächsten Satz von Bytes aus der Remote Datei. Diese API schlägt fehl, wenn "Read First" nicht bereits für "dkmfiletransferstream" aufgerufen wurde. |
| RemoveDataItem<T>() |
Entfernen Sie die Instanz von 't "aus diesem Container. Es ist in der Regel nicht erforderlich, diese Methode aufzurufen, da ein Datencontainer automatisch geleert wird, wenn das Objekt geschlossen wird. (Geerbt von DkmDataContainer) |
| SetDataItem<T>(DkmDataCreationDisposition, T) |
Fügen Sie ein neues Element in den Datencontainer ein. (Geerbt von DkmDataContainer) |
| WriteFirst(Byte[], UInt64, UInt64, Boolean) |
Startet einen Remote Datei Schreibvorgang. Die Remote Datei wird geöffnet, und die Bytes aus dem Inhalt werden in diese Datei geschrieben. Wenn zusätzliche Bytes über den Inhalt hinaus übertragen werden sollen, sollte "beschreitenext" aufgerufen werden, um diese zu übertragen. Wenn das Verzeichnis dieser Datei nicht vorhanden ist, versucht der Debugger, es zu erstellen. |
| WriteNext(Byte[]) |
Schreibt den nächsten Satz von Bytes in die Remote Datei. Diese API schlägt fehl, wenn "Write-First" nicht bereits für "dkmfiletransferstream" aufgerufen wurde. |
Explizite Schnittstellenimplementierungen
| IDisposable.Dispose() |