ThreadPool.UnsafeQueueUserWorkItem Método

Definição

Namespace:

System.Threading

Assembly:

System.Threading.ThreadPool.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Sobrecargas

UnsafeQueueUserWorkItem(IThreadPoolWorkItem, Boolean)	Coloca o objeto de item de trabalho especificado na fila do pool de threads.
UnsafeQueueUserWorkItem(WaitCallback, Object)	Enfileira o delegado especificado no pool de threads, mas não propagar a pilha de chamadas para o thread de trabalho.
UnsafeQueueUserWorkItem<TState>(Action<TState>, TState, Boolean)	Enfileira um método especificado por um delegado de Action<T> para execução e especifica um objeto que contém os dados a serem usados pelo método. O método é executado quando um thread de pool de threads se torna disponível.

UnsafeQueueUserWorkItem(IThreadPoolWorkItem, Boolean)

Coloca o objeto de item de trabalho especificado na fila do pool de threads.

public:
 static bool UnsafeQueueUserWorkItem(System::Threading::IThreadPoolWorkItem ^ callBack, bool preferLocal);

public static bool UnsafeQueueUserWorkItem (System.Threading.IThreadPoolWorkItem callBack, bool preferLocal);

static member UnsafeQueueUserWorkItem : System.Threading.IThreadPoolWorkItem * bool -> bool

Public Shared Function UnsafeQueueUserWorkItem (callBack As IThreadPoolWorkItem, preferLocal As Boolean) As Boolean

Parâmetros

callBack

IThreadPoolWorkItem

O item de trabalho a ser invocado quando um thread do pool de threads seleciona o item de trabalho.

preferLocal

Boolean

true para indicar a preferência por colocar o item de trabalho em uma fila próximo ao thread atual; false para indicar a preferência por colocar o item de trabalho na fila compartilhada do pool de threads.

Retornos

Boolean

true se o método tiver êxito; OutOfMemoryException será gerado se não for possível colocar o item de trabalho na fila.

Exceções

ArgumentNullException

callback é null.

ArgumentOutOfRangeException

O item de trabalho é uma Task.

OutOfMemoryException

Não foi possível colocar o item de trabalho na fila.

Comentários

O pool de threads invocará o método do item de Execute() trabalho. É responsabilidade desse item de trabalho propagar ExecutionContext se necessário; o pool de threads não o fará.

UnsafeQueueUserWorkItem(WaitCallback, Object)

Enfileira o delegado especificado no pool de threads, mas não propagar a pilha de chamadas para o thread de trabalho.

public:
 static bool UnsafeQueueUserWorkItem(System::Threading::WaitCallback ^ callBack, System::Object ^ state);

public static bool UnsafeQueueUserWorkItem (System.Threading.WaitCallback callBack, object? state);

public static bool UnsafeQueueUserWorkItem (System.Threading.WaitCallback callBack, object state);

[System.Security.SecurityCritical]
public static bool UnsafeQueueUserWorkItem (System.Threading.WaitCallback callBack, object state);

static member UnsafeQueueUserWorkItem : System.Threading.WaitCallback * obj -> bool

[<System.Security.SecurityCritical>]
static member UnsafeQueueUserWorkItem : System.Threading.WaitCallback * obj -> bool

Public Shared Function UnsafeQueueUserWorkItem (callBack As WaitCallback, state As Object) As Boolean

Parâmetros

callBack

WaitCallback

Um WaitCallback que retrata o delegado a ser invocado quando um thread no pool de threads coleta o item de trabalho.

state

Object

O objeto que é passado para o representante quando este recebe manutenção do pool de threads.

Retornos

Boolean

true se o método tiver êxito; OutOfMemoryException será gerado se não for possível colocar o item de trabalho na fila.

Atributos

SecurityCriticalAttribute

Exceções

SecurityException

O chamador não tem a permissão necessária.

ApplicationException

Uma condição de memória insuficiente foi encontrada.

OutOfMemoryException

Não foi possível colocar o item de trabalho na fila.

ArgumentNullException

callBack é null.

Comentários

Ao contrário do QueueUserWorkItem método, UnsafeQueueUserWorkItem não propaga a pilha de chamadas para o thread de trabalho. Isso permite que o código perca a pilha de chamadas e, assim, eleve seus privilégios de segurança.

Cuidado

Usar UnsafeQueueUserWorkItem pode abrir inadvertidamente uma falha de segurança. A segurança de acesso ao código baseia suas verificações de permissão nas permissões de todos os chamadores na pilha. Quando o trabalho é enfileirado em um thread de pool de threads usando UnsafeQueueUserWorkItem, a pilha do thread do pool de threads não terá o contexto dos chamadores reais. O código mal-intencionado pode explorar isso para evitar verificações de permissão.

Confira também

• O pool de threads gerenciados

UnsafeQueueUserWorkItem<TState>(Action<TState>, TState, Boolean)

Enfileira um método especificado por um delegado de Action<T> para execução e especifica um objeto que contém os dados a serem usados pelo método. O método é executado quando um thread de pool de threads se torna disponível.

public:
generic <typename TState>
 static bool UnsafeQueueUserWorkItem(Action<TState> ^ callBack, TState state, bool preferLocal);

public static bool UnsafeQueueUserWorkItem<TState> (Action<TState> callBack, TState state, bool preferLocal);

static member UnsafeQueueUserWorkItem : Action<'State> * 'State * bool -> bool

Public Shared Function UnsafeQueueUserWorkItem(Of TState) (callBack As Action(Of TState), state As TState, preferLocal As Boolean) As Boolean

Parâmetros de tipo

TState

O tipo dos elementos de state.

Parâmetros

callBack

Action<TState>

Um delegado que representa o método a ser executado.

state

TState

Um objeto que contém dados a serem usados pelo método.

preferLocal

Boolean

true para indicar a preferência por colocar o item de trabalho em uma fila próximo ao thread atual; false para indicar a preferência por colocar o item de trabalho na fila compartilhada do pool de threads.

Retornos

Boolean

true se o método for colocado na fila com êxito; NotSupportedException será gerado se o item de trabalho não puder ser colocado na fila.

Exceções

ArgumentNullException

callback é null.

NotSupportedException

Não foi possível colocar o item de trabalho na fila.