DependencyObjectCollection Classe
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.
Implementa uma classe de coleção prática que pode conter itens DependencyObject .
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyObjectCollection : DependencyObject, IIterable<DependencyObject>, IObservableVector<DependencyObject>, IVector<DependencyObject>[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DependencyObjectCollection : DependencyObject, IEnumerable<DependencyObject>, IList<DependencyObject>, IObservableVector<DependencyObject>Public Class DependencyObjectCollection
Inherits DependencyObject
Implements IEnumerable(Of DependencyObject), IList(Of DependencyObject), IObservableVector(Of DependencyObject)- Herança
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
A finalidade da classe DependencyObjectCollection é principalmente dar suporte às ferramentas e à portabilidade de comportamentos. Os comportamentos são uma técnica para definir determinadas interações básicas de um elemento de interface do usuário inteiramente em XAML, sem a necessidade de um manipulador de eventos e code-behind.
Se você estiver interessado em implementar uma classe de objeto de negócios que dê suporte a notificações alteradas na coleção, use ObservableCollection ou um dos padrões de interface que dão suporte a eventos alterados. Para obter mais informações, consulte Associação de dados em detalhes.
Enumerando a coleção em C# ou Microsoft Visual Basic
Um DependencyObjectCollection é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C# para enumerar os itens na coleção. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<DependencyObject> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição DependencyObject .
Construtores
| DependencyObjectCollection() |
Inicializa uma nova instância da classe DependencyObjectCollection . |
Propriedades
| Dispatcher |
Obtém o CoreDispatcher ao qual esse objeto está associado. O CoreDispatcher representa uma instalação que pode acessar o DependencyObject no thread da interface do usuário, mesmo que o código seja iniciado por um thread que não seja da interface do usuário. (Herdado de DependencyObject) |
| Size |
Obtém o tamanho (contagem) da coleção. |
Métodos
| Append(DependencyObject) |
Adiciona um novo item à coleção. |
| Clear() |
Remove todos os itens da coleção. |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade de dependência. (Herdado de DependencyObject) |
| First() |
Retorna o iterador para iteração sobre os itens na coleção. |
| GetAnimationBaseValue(DependencyProperty) |
Retorna qualquer valor base estabelecido para uma propriedade de dependência, que se aplicaria nos casos em que uma animação não está ativa. (Herdado de DependencyObject) |
| GetAt(UInt32) |
Retorna o DependencyObject localizado no índice especificado. |
| GetMany(UInt32, DependencyObject[]) |
Recupera vários elementos em uma única passagem pelo iterador. |
| GetValue(DependencyProperty) |
Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject) |
| GetView() |
Obtém uma exibição imutável na coleção. |
| IndexOf(DependencyObject, UInt32) |
Recupera o índice do item especificado. |
| InsertAt(UInt32, DependencyObject) |
Insere o item especificado no índice especificado. |
| ReadLocalValue(DependencyProperty) |
Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra uma função de notificação para escutar alterações em uma DependencyProperty específica nessa instância dependencyObject . (Herdado de DependencyObject) |
| RemoveAt(UInt32) |
Remove o item no índice especificado. |
| RemoveAtEnd() |
Remove o último item da coleção. |
| ReplaceAll(DependencyObject[]) |
Inicialmente limpa a coleção e insere a matriz fornecida como novos itens. |
| SetAt(UInt32, DependencyObject) |
Define o valor no índice especificado como o valor DependencyObject especificado. |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela uma notificação de alteração que foi registrada anteriormente chamando RegisterPropertyChangedCallback. (Herdado de DependencyObject) |
Eventos
| VectorChanged |
Ocorre quando o conteúdo da coleção é alterado. |