BulkFileOperation Class

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Package:: Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

BulkFileOperation provides functionality to safely perform operations with bulk of files, currently opened in the solution. One of the example is SCC. Before operation consumer should provide estimated set of files and folders where changes are expected. This class takes care about "hands-off" logic for all these files. Once operation done BulkFileOperation does all neccessary job for "hands-on" logic and make a decision on what to reload (project/solution/nothing). Order of operations is the following: QueryBulkFileOperationAsync BeginAsync (optional) EndAsync (optional, but BeginAsync is required to complete before this) Dispose This API is very strict to inappropriate usage, for example calling EndAsync without waiting for BeginAsync is done, or calling the same method twice and so on. In this case exception will be thrown.

public ref class BulkFileOperation : Microsoft::VisualStudio::PlatformUI::DisposableObject

public ref class BulkFileOperation : Microsoft::VisualStudio::PlatformUI::DisposableObject, Microsoft::Internal::VisualStudio::Shell::Interop::IVsSolutionReloadBatchHandler

public class BulkFileOperation : Microsoft.VisualStudio.PlatformUI.DisposableObject

public class BulkFileOperation : Microsoft.VisualStudio.PlatformUI.DisposableObject, Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler, Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler2

type BulkFileOperation = class
    inherit DisposableObject

type BulkFileOperation = class
    inherit DisposableObject
    interface IVsSolutionReloadBatchHandler2
    interface IVsSolutionReloadBatchHandler

Public Class BulkFileOperation
Inherits DisposableObject

Public Class BulkFileOperation
Inherits DisposableObject
Implements IVsSolutionReloadBatchHandler, IVsSolutionReloadBatchHandler2

Inheritance: Object

DisposableObject
BulkFileOperation

Implements: Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler2

Properties

IsDisposed	Returns whether the object has been disposed once, protects against double disposal (Inherited from DisposableObject)
IsInProgress	Gets indication whether some BulkFileOperation is in progress right now. It would be useful in several cases: to avoid getting exception if you want to run new BulkFileOperation; to not lost current context, when subscibes on Begin/End events.
IsSynchronousUpdateNeeded	Gets value whether synchronous update will be needed after bulk file operation is done.
ProjectsToReload	Gets list of the full path to the project files which will have to be reloaded/updated with requested bulk file operation.
TelemetryInfo	Get information about statistics for the current BulkFileOperation. It is possible to attach it to the event and have additional information about timings and counts.
UnsavedFiles	The subset of document file paths which are currently in use.

Methods

BeginAsync(CancellationToken)	Start bulk file operation based on the previous QueryBulkFileOperationAsync method.
Dispose()	Disposes the current object then suppresses further finalization. (Inherited from DisposableObject)
Dispose(Boolean)	Standard virtual overload for IDisposable pattern (Inherited from DisposableObject)
DisposeManagedResources()	There is no protection from calling this method while other methods are in progress. For example, if BeginAsync is in progress and customer calls Dispose() it will silently dispose resources and moves object to Disposed state.
DisposeNativeResources()	Allows derived classes to provide custom dispose handling for native resources (Inherited from DisposableObject)
EndAsync()	Completes bulk file operation. Makes necessary decisions on what to reload (project/solution/nothing). Does all hands-on logic and adds files/folders on track. This method is not cancellable, because otherwise system will be in unknown state: some files were handed-on, some not; if projects/solution file were updated, and solution were not reloaded, which is the bad UX experience.
QueryBulkFileOperationAsync(IEnumerable<String>, IEnumerable<String>, CancellationToken)	Start bulk file operation. This method is called by customer prior start some bulk file operation, for example git checkout.
ThrowIfDisposed()	Throws an ObjectDisposedException if this object has been disposed (Inherited from DisposableObject)

Events

BeforeFlushPendingFileChangeNotification	Sends BeforeFlushPendingFileChangeNotification signal when BulkFileOperation ends before we resume FileChange service.
Begin	Sends Begin signal when BulkFileOperation begin and we processed all pending FileChange service signals and pause it.
Disposing	Raised when the event is being disposed, while it is still accessible. (Inherited from DisposableObject)
End	Sends End signal when BulkFileOperation ends at the very end.

Explicit Interface Implementations

IVsSolutionReloadBatchHandler.CanCommitBatch(IVsSolutionReloadBatch, UInt32, UInt32, UInt32)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanCommitBatch(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.UInt32,System.UInt32@)
IVsSolutionReloadBatchHandler.CanCommitBatchUI(IVsSolutionReloadBatch, UInt32, UInt32, UInt32)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanCommitBatchUI(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.UInt32,System.UInt32@)
IVsSolutionReloadBatchHandler.CanGiveControl(IVsSolutionReloadBatchHandler)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanGiveControl(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler.CanJoin(IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler.CanTakeControl(IVsSolutionReloadBatchHandler)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanTakeControl(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler.ExecuteReloadUI(IVsSolutionReloadBatch, UInt32, Guid[], UInt32[])	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.ExecuteReloadUI(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.Guid[],System.UInt32[])
IVsSolutionReloadBatchHandler.HandlerId	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.HandlerId
IVsSolutionReloadBatchHandler2.CanCommitBatch(IVsSolutionReloadBatch, UInt32, UInt32, UInt32)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanCommitBatch(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.UInt32,System.UInt32@)
IVsSolutionReloadBatchHandler2.CanCommitBatchUI(IVsSolutionReloadBatch, UInt32, UInt32, UInt32)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanCommitBatchUI(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.UInt32,System.UInt32@)
IVsSolutionReloadBatchHandler2.CanGiveControl(IVsSolutionReloadBatchHandler)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanGiveControl(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler2.CanJoin(IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler2.CanTakeControl(IVsSolutionReloadBatchHandler)	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.CanTakeControl(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler)
IVsSolutionReloadBatchHandler2.ExecuteReloadUI(IVsSolutionReloadBatch, UInt32, Guid[], UInt32[])	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.ExecuteReloadUI(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.Guid[],System.UInt32[])
IVsSolutionReloadBatchHandler2.ExecuteReloadWithProjectDefinitionsUI(IVsSolutionReloadBatch, UInt32, Guid[], IVsProjectDefinitionInSolution[], UInt32[])	System.Object.Microsoft#Internal#VisualStudio#Shell#Interop#IVsSolutionReloadBatchHandler2#ExecuteReloadWithProjectDefinitionsUI(Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatch,System.UInt32,System.Guid[],Microsoft.Internal.VisualStudio.Shell.Interop.IVsProjectDefinitionInSolution[],System.UInt32[])
IVsSolutionReloadBatchHandler2.HandlerId	Microsoft.Internal.VisualStudio.Shell.Interop.IVsSolutionReloadBatchHandler.HandlerId

Applies to

Partilhar via