Share via


Chain Class

Definition

Represents a chain of events that are recorded from a running application. Chains can be accessed in random order and traversed forward or backward. Because a chain can be examined while the application is still running, the chain may grow (or shrink) between inspections. Enumerating through events in a chain is generally done by calling FirstValidToken to get the first EventToken in the chain and then calling GetNextToken(EventToken) to move forward (or GetPreviousToken(EventToken) to move backward).

public ref class Chain abstract : IDisposable, System::Collections::Generic::IEnumerable<Microsoft::VisualStudio::IntelliTrace::IntelliTraceEvent ^>
public abstract class Chain : IDisposable, System.Collections.Generic.IEnumerable<Microsoft.VisualStudio.IntelliTrace.IntelliTraceEvent>
type Chain = class
    interface IDisposable
    interface seq<IntelliTraceEvent>
    interface IEnumerable
Public MustInherit Class Chain
Implements IDisposable, IEnumerable(Of IntelliTraceEvent)
Inheritance
Chain
Derived
Implements

Constructors

Chain()

Properties

AfterLastToken

When overridden in a derived class, gets an EventToken for the position immediately after the current LastToken. If additional events get added to the chain, the token returned from AfterLastToken will become valid. This property is available even if CanGetLastToken returns false.

BeforeFirstToken

Gets an EventToken for the position immediately before FirstToken. This token will never become valid.

CanGetCount

Gets a value that determines if the chain supports Count.

CanGetLastToken

Gets a value that determines if the chain supports LastToken.

CanGetPreviousToken

Gets a value that determines if the chain supports GetPreviousToken(EventToken).

Count

Gets the number of events in the chain. This property can only be called if CanGetCount returns true.

FirstToken

When overridden in a derived class, gets an EventToken for the first event in the chain.

FirstValidToken

When overridden in a derived class, gets an EventToken for the first valid event in the chain.

IsEmpty

When overridden in a derived class, gets a value that indicates if the chain is empty.

LastToken

Gets an EventToken for the last event in the chain. This property can only be called if CanGetLastToken returns true.

Methods

Dispose()

Releases resources used by this chain.

Dispose(Boolean)

Releases the resources used by this chain.

GetEnumerator()
GetEnumerator<TEvent>()
GetEvent(EventToken)

When overridden in a derived class, gets an IntelliTraceEvent for the specified EventToken.

GetEvents(EventToken, EventToken)

When overridden in a derived class, gets multiple IntelliTraceEvents from a start EventToken up to but not including an end EventToken.

GetNextToken(EventToken)

When overridden in a derived class, gets the EventToken for the next event after the given EventToken.

GetPreviousToken(EventToken)

Gets the EventToken for the previous event before the given EventToken.

IsValidEventType(IntelliTraceEvent)

When overridden in a derived class, determines if the given IntelliTraceEvent is valid for this chain.

IsValidToken(EventToken)

When overridden in a derived class, determines if the given EventToken is valid for this chain.

Tokens()

Explicit Interface Implementations

IEnumerable.GetEnumerator()

Extension Methods

EmptyIfNull<T>(IEnumerable<T>)

Return this enumeration in case it is not null. In case it is null return empty enumeration.

Applies to