Freigeben über


IFileStagingArtifact Schnittstelle

Definition

Enthält Informationen zu einem Datei-Stagingprozess. Das Dateising wird in der Regel für ein CloudTask ausgeführt (siehe FilesToStage).

public interface IFileStagingArtifact
type IFileStagingArtifact = interface
Public Interface IFileStagingArtifact
Abgeleitet

Hinweise

IFileStagingArtifact ermöglicht einer Anwendung das Anpassen und Abrufen von Informationen über den Prozess des Hochladens von Dateien in die Cloud, z. B. im Rahmen eines aufgabenbezogenen Vorgangs wie JobOperations.AddTaskAsync oder CloudJob.AddTaskAsync. Anwendungen können diese Informationen verwenden, um sich beispielsweise über Container zu informieren, die im Rahmen des Uploadprozesses in Azure Storage erstellt wurden.

Wenn JobOperations.AddTaskAsync aufgerufen wird, sendet der Batch-Client die Aufgaben in Sammlungen an den Batch-Dienst. Während die einzelnen Auflistungen verarbeitet werden, führt der Batch-Client das Datei-Staging für diese Auflistung durch: Er untersucht die Aufgaben, um festzustellen, ob eine dieser Aufgaben eine FilesToStageAngabe enthält, und erstellt in diesem Fall einen Wörterbucheintrag für jeden Typ von IFileStagingProvider in der FilesToStage-Auflistung. Der Schlüssel des Wörterbucheintrags ist der Type des IFileStagingProvider, und der Wert ist ein instance der entsprechenden Implementierung von IFileStagingArtifact. Wenn FilesToStage beispielsweise ein oder mehrere FileToStage-Objekte (aus der Microsoft.Azure.Batch.FileStaging-Bibliothek) enthält, enthält das Wörterbuch einen Eintrag, dessen Schlüssel typeof(FileToStage) ist und dessen Wert ein instance von SequentialFileStagingArtifact ist.

Nach Abschluss des Vorgangs "Aufgabe hinzufügen" oder während des Vorgangs "Aufgabe hinzufügen", wenn die Anwendung multithreaded ist, können Sie das Wörterbuch untersuchen und jede IFileStagingArtifact in den entsprechenden Typ konvertieren, um die typspezifischen Informationen abzurufen. Wenn Ihr Vorgang "Task hinzufügen" beispielsweise ein oder mehrere FileToStage-Objekte angegeben hat, können Sie den nach typeof(FileToStage) schlüsselierten Wörterbucheintrag suchen, den Wert in SequentialFileStagingArtifact umwandeln und die SequentialFileStagingArtifact.BlobContainerCreated-Eigenschaft untersuchen, um zu ermitteln, ob der Uploadprozess einen Blobcontainer in Azure Storage und ggf. den Namen dieses Containers erstellt hat. Dieses Beispiel kann nützlich sein, um automatisch erstellte Container zu bereinigen.

(Vorgänge zum Hinzufügen von Aufgaben für einzelne Aufgaben funktionieren ähnlich, mit dem Unterschied, dass in einem Vorgang zum Hinzufügen von Aufgaben mit mehreren Aufgaben ein Wörterbuch für jede Sammlung von Aufgaben vorhanden ist, und die Wörterbücher in einem ConcurrentBag<T>erfasst werden, während es in einem Vorgang "Aufgabe hinzufügen" nur ein einzelnes Wörterbuch gibt.)

In einem Vorgang "Aufgabe hinzufügen" können Sie das Wörterbuch auch verwenden, um den Datei-Stagingprozess anzupassen, indem Sie ihn mit entsprechenden Einträgen vorab auffüllen. Angenommen, Sie möchten die NamingFragment für eine Gruppe von FileToStage-Objekten steuern. Anschließend können Sie das Wörterbuch mit { typeof(FileToStage), new SequentialFileStagingArtifact { NamingFragment = "myname" } } initialisieren, bevor Sie es an AddTaskAsync übergeben. Die FileToStage-Implementierung von IFileStagingProvider verwendet dann Ihr SequentialFileStagingArtifact, anstatt eine eigene zu erstellen. (Dieses Feature ist in Vorgängen zum Hinzufügen von Aufgaben mit mehreren Aufgaben nicht verfügbar.)

Möglicherweise stoßen Sie auch auf IFileStagingArtifact, wenn Sie einen benutzerdefinierten IFileStagingProviderentwickeln. In diesem Fall erstellen Sie in der Regel eine benutzerdefinierte Implementierung von IFileStagingArtifact, um implementierungsspezifische Informationen zu Ihrem Datei-Stagingprozess zu melden.

Eigenschaften

NamingFragment

Ruft ein Namensfragment ab, das beim Erstellen von Standardnamen verwendet werden kann, oder legt es fest.

Gilt für: