ExecutionContext.SuppressFlow Method (System.Threading)

.NET Framework Class Library

ExecutionContext..::.SuppressFlow Method

Suppresses the flow of the execution context across asynchronous threads.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

<SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags := SecurityPermissionFlag.Infrastructure)> _
Public Shared Function SuppressFlow As AsyncFlowControl

Visual Basic (Usage)

Dim returnValue As AsyncFlowControl

returnValue = ExecutionContext.SuppressFlow()

[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.Infrastructure)]
public static AsyncFlowControl SuppressFlow()

Visual C++

[SecurityPermissionAttribute(SecurityAction::LinkDemand, Flags = SecurityPermissionFlag::Infrastructure)]
public:
static AsyncFlowControl SuppressFlow()

JScript

public static function SuppressFlow() : AsyncFlowControl

Return Value

Type: System.Threading..::.AsyncFlowControl
An AsyncFlowControl structure for restoring the flow.

Exceptions

Exception	Condition
InvalidOperationException	The context flow is already suppressed.

Remarks

Use this method to suppress the flow of the ExecutionContext on the current thread.

You must use the Undo method on the returned AsyncFlowControl structure to restore the flow of the ExecutionContext.

This method is protected with a SecurityAction..::.LinkDemand for SecurityPermissionFlag..::.Infrastructure permission. A fully trusted component can call this method to suppress the flow of the ExecutionContext during asynchronous calls. While the flow is suppressed, the Capture method returns nullNothingnullptra null reference (Nothing in Visual Basic).

Examples

The following code example shows the use of the SuppressFlow method. This example is part of a larger example provided for the ExecutionContext class.

Visual Basic

Console.WriteLine("Suppress the flow of the execution context.")
Dim aFC As AsyncFlowControl = ExecutionContext.SuppressFlow()

Console.WriteLine("Suppress the flow of the execution context.");
AsyncFlowControl aFC = ExecutionContext.SuppressFlow();

Visual C++

Console::WriteLine("Suppress the flow of the execution context.");
AsyncFlowControl aFC = ExecutionContext::SuppressFlow();

.NET Framework Security

SecurityPermission
for operating with infrastructure code. Demand value: SecurityAction..::.LinkDemand; Permission value: SecurityPermissionFlag..::.Infrastructure

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

ExecutionContext Class

ExecutionContext Members

System.Threading Namespace

AsyncFlowControl