ThreadPool.UnsafeQueueUserWorkItem Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| UnsafeQueueUserWorkItem(IThreadPoolWorkItem, Boolean) |
Enfileira o objeto de item de trabalho especificado para o pool de threads. |
| UnsafeQueueUserWorkItem(WaitCallback, Object) |
Enfileira o delegado especificado para o pool de threads, mas não propaga a pilha de chamadas para o thread de trabalho. |
| UnsafeQueueUserWorkItem<TState>(Action<TState>, TState, Boolean) |
Enfileira um método especificado por um Action<T> delegado para execução e especifica um objeto que contém dados a serem usados pelo método. O método é executado quando um thread do pool de threads fica disponível. |
UnsafeQueueUserWorkItem(IThreadPoolWorkItem, Boolean)
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
Enfileira o objeto de item de trabalho especificado para o 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 -> boolPublic Shared Function UnsafeQueueUserWorkItem (callBack As IThreadPoolWorkItem, preferLocal As Boolean) As BooleanParâmetros
- callBack
- IThreadPoolWorkItem
O item de trabalho a ser invocado quando um thread no pool de threads pegar o item de trabalho.
- preferLocal
- Boolean
true para preferir enfileirar o item de trabalho em uma fila próxima ao thread atual; false para preferir enfileirar o item de trabalho para a fila compartilhada do pool de threads.
Retornos
true se o método for bem-sucedido; OutOfMemoryException será gerado se o item de trabalho não puder ser enfileirado.
Exceções
callBack é null.
O item de trabalho é um Task.
Não foi possível enfileirar o item de trabalho.
Comentários
O pool de threads invocará o método do item de Execute() trabalho. É responsabilidade desse item de trabalho propagar ExecutionContext se for necessário; o pool de threads não o fará.
Aplica-se a
UnsafeQueueUserWorkItem(WaitCallback, Object)
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
Enfileira o delegado especificado para o pool de threads, mas não propaga 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 -> boolPublic Shared Function UnsafeQueueUserWorkItem (callBack As WaitCallback, state As Object) As BooleanParâmetros
- callBack
- WaitCallback
Um WaitCallback que representa o delegado a ser invocado quando um thread no pool de threads pega o item de trabalho.
- state
- Object
O objeto que é passado para o delegado quando atendido do pool de threads.
Retornos
true se o método for bem-sucedido; OutOfMemoryException será gerado se o item de trabalho não puder ser enfileirado.
- Atributos
Exceções
O chamador não tem a permissão necessária.
Uma condição de memória insuficiente foi encontrada.
Não foi possível enfileirar o item de trabalho.
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 do pool de threads usando UnsafeQueueUserWorkItem, a pilha do thread do pool de threads não terá o contexto dos chamadores reais. Código mal-intencionado pode ser capaz de explorar isso para evitar verificações de permissão.
Confira também
Aplica-se a
UnsafeQueueUserWorkItem<TState>(Action<TState>, TState, Boolean)
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
- Origem:
- ThreadPoolWorkQueue.cs
Enfileira um método especificado por um Action<T> delegado para execução e especifica um objeto que contém dados a serem usados pelo método. O método é executado quando um thread do pool de threads fica 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 -> boolPublic Shared Function UnsafeQueueUserWorkItem(Of TState) (callBack As Action(Of TState), state As TState, preferLocal As Boolean) As BooleanParâmetros de tipo
- TState
O tipo de 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 preferir enfileirar o item de trabalho em uma fila próxima ao thread atual; false para preferir enfileirar o item de trabalho para a fila compartilhada do pool de threads.
Retornos
true se o método for enfileirado com êxito; NotSupportedException será gerado se o item de trabalho não puder ser enfileirado.
Exceções
callBack é null.
Não foi possível enfileirar o item de trabalho.
