Share via


ITableEntryHandle.PinSnapshot Method

Definition

Pin the snapshot for this ITableEntryHandle.

public:
 Microsoft::VisualStudio::Shell::TableManager::ITableEntriesSnapshot ^ PinSnapshot();
public Microsoft.VisualStudio.Shell.TableManager.ITableEntriesSnapshot PinSnapshot ();
abstract member PinSnapshot : unit -> Microsoft.VisualStudio.Shell.TableManager.ITableEntriesSnapshot
Public Function PinSnapshot () As ITableEntriesSnapshot

Returns

The ITableEntriesSnapshot used to create this entry or null if it or its equivalent no longer exists.

Remarks

All calls to PinSnapshot() should be matched by calls to UnpinSnapshot().

This will return null (and have no effect) on handles created from ITableEntrys.

If the ITableEntriesSnapshot used to create this handle was directly added to the ITableDataSink, then this method will return that snapshot (but have no effect otherwise).

If the ITableEntriesSnapshot used to create this handle is managed by an ITableEntriesSnapshotFactory, then this method will return its cached snapshot if still exists or it will ask the factory to recreate it if it does not. The factory may not be able to recreate the snapshot and, in that case, this method will return null.

Applies to