Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe DependencyProperty

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Representa uma propriedade que pode ser definida por meio de métodos como estilos, vinculação de dados, animação e herança.

Namespace:   System.Windows
Assembly:  WindowsBase (em WindowsBase.dll)

System.Object
  System.Windows.DependencyProperty

[TypeConverterAttribute("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty

NomeDescrição
System_CAPS_pubpropertyDefaultMetadata

Obtém os metadados padrão da propriedade de dependência.

System_CAPS_pubpropertyGlobalIndex

Obtém um valor gerado internamente que identifica exclusivamente a propriedade de dependência.

System_CAPS_pubpropertyName

Obtém o nome da propriedade de dependência.

System_CAPS_pubpropertyOwnerType

Obtém o tipo do objeto que registrou a propriedade de dependência com o sistema de propriedade ou que adicionou a si próprio como proprietário da propriedade.

System_CAPS_pubpropertyPropertyType

Obtém o tipo que usa a propriedade de dependência para seu valor.

System_CAPS_pubpropertyReadOnly

Obtém um valor que indica se a propriedade de dependência é identificado por esse DependencyProperty instância é uma propriedade de dependência somente leitura.

System_CAPS_pubpropertyValidateValueCallback

Obtém o retorno de chamada de validação do valor da propriedade de dependência.

NomeDescrição
System_CAPS_pubmethodAddOwner(Type)

Adiciona outro tipo como um proprietário de uma propriedade de dependência que já foi registrado.

System_CAPS_pubmethodAddOwner(Type, PropertyMetadata)

Adiciona outro tipo como um proprietário de uma propriedade de dependência que já foi registrada, fornecendo metadados de propriedade de dependência para a propriedade de dependência como ela existe no tipo do proprietário fornecido.

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Retorna um código hash para este DependencyProperty.(Substitui o Object.GetHashCode().)

System_CAPS_pubmethodGetMetadata(DependencyObject)

Retorna os metadados para essa propriedade de dependência conforme ela existe na instância do objeto especificado.

System_CAPS_pubmethodGetMetadata(DependencyObjectType)

Retorna os metadados para essa propriedade de dependência conforme ela existe em um tipo especificado.

System_CAPS_pubmethodGetMetadata(Type)

Retorna os metadados para essa propriedade de dependência uma vez que ela existe em um tipo existente especificado.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodIsValidType(Object)

Determina se um valor especificado é aceitável para o tipo da propriedade de dependência, como verificado em relação ao tipo de propriedade fornecido no registro de propriedade de dependência original.

System_CAPS_pubmethodIsValidValue(Object)

Determina se o valor fornecido é aceita para o tipo de propriedade por meio de verificação de tipo básico e também potencialmente se ele está dentro do intervalo permitido de valores para esse tipo.

System_CAPS_pubmethodOverrideMetadata(Type, PropertyMetadata)

Especifica os metadados alternativos para essa propriedade de dependência quando está presente em instâncias de um tipo especificado, substituindo os metadados existentes para a propriedade de dependência conforme ela foi herdada dos tipos base.

System_CAPS_pubmethodOverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Fontes alternam metadados para uma propriedade de dependência somente leitura quando ele está presente em instâncias de um tipo especificado, substituindo os metadados que foi fornecido no registro de propriedade de dependência inicial. Você deve passar o DependencyPropertyKey para a propriedade de dependência somente leitura para não gerar uma exceção.

System_CAPS_pubmethodSystem_CAPS_staticRegister(String, Type, Type)

Registra uma propriedade de dependência com o nome de propriedade, tipo de propriedade e tipo de proprietário especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegister(String, Type, Type, PropertyMetadata)

Registra uma propriedade de dependência com o nome de propriedade, tipo de propriedade, tipo de proprietário e metadados de propriedade especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegister(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra uma propriedade de dependência com o nome da propriedade, tipo de propriedade, tipo de proprietário, metadados de propriedade especificados e um retorno de chamada de validação do valor da propriedade.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(String, Type, Type)

Registra uma propriedade anexada com o nome de propriedade, o tipo de propriedade e o tipo de proprietário especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(String, Type, Type, PropertyMetadata)

Registra uma propriedade anexada com o nome de propriedade, tipo de propriedade, tipo de proprietário e metadados de propriedade especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra uma propriedade anexada com o tipo de propriedade, o tipo de proprietário, os metadados de propriedade e o retorno de chamada de validação de valor da propriedade especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

Registra uma propriedade anexada somente leitura com o tipo de propriedade, tipo de proprietário e metadados de propriedade especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra uma propriedade anexada somente leitura, com o tipo de propriedade especificado, o tipo de proprietário, metadados de propriedade e um retorno de chamada de validação.

System_CAPS_pubmethodSystem_CAPS_staticRegisterReadOnly(String, Type, Type, PropertyMetadata)

Registra uma propriedade de dependência somente leitura com o tipo da propriedade, tipo de proprietário e metadados de propriedade especificados.

System_CAPS_pubmethodSystem_CAPS_staticRegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Registra uma propriedade de dependência somente leitura, com o tipo de propriedade especificado, o tipo de proprietário, metadados de propriedade e um retorno de chamada de validação.

System_CAPS_pubmethodToString()

Retorna a representação de cadeia de caracteres da propriedade de dependência.(Substitui o Object.ToString().)

NomeDescrição
System_CAPS_pubfieldSystem_CAPS_staticUnsetValue

Especifica um valor estático que é usado pelo sistema da propriedade WPF em vez de null para indicar que a propriedade existe, mas não tem seu valor definido pelo sistema da propriedade.

Um DependencyProperty suporta os seguintes recursos no Windows Presentation Foundation (WPF):

  • A propriedade pode ser definida em um estilo. Para obter mais informações, consulte Estilo e modelagem.

  • A propriedade pode ser definida por meio de associação de dados. Para obter mais informações sobre propriedades de dependência de associação de dados, consulte como: associar as propriedades de dois controles.

  • A propriedade pode ser definida com uma referência de recurso dinâmico. Para obter mais informações, consulte Recursos XAML.

  • A propriedade pode herdar seu valor automaticamente de um elemento pai na árvore de elementos. Para obter mais informações, consulte Herança do valor da propriedade.

  • A propriedade pode ser animada. Para obter mais informações, consulte Visão geral de animação.

  • A propriedade pode relatar quando o valor anterior da propriedade foi alterado e o valor da propriedade pode ser forçado. Para obter mais informações, consulte Retornos de chamada da propriedade de dependência e validação.

  • A propriedade informa ao WPF, como se a alteração de um valor de propriedade deve exigir o sistema de layout para recompor a visualização de um elemento.

  • A propriedade recebe suporte a WPF Designer for Visual Studio. Por exemplo, a propriedade pode ser editada no propriedades janela.

Para saber mais sobre as propriedades de dependência, consulte visão geral de propriedades de dependência. Se você quiser propriedades em seus tipos personalizados para dar suporte os recursos da lista anterior, você deve criar uma propriedade de dependência. Para saber como criar propriedades de dependência personalizadas, consulte propriedades personalizadas de dependência.

Uma propriedade anexada é uma propriedade que permite que qualquer objeto de informações de relatório para o tipo que define a propriedade anexada. Em WPF, qualquer tipo que herda de DependencyObject pode usar uma propriedade anexada, independentemente se o tipo herda do tipo que define a propriedade. Uma propriedade anexada é um recurso do XAML idioma.  Para definir uma propriedade anexada no XAML, use o ownerType. propertyName sintaxe. É um exemplo de uma propriedade anexada a DockPanel.Dock propriedade. Se você deseja criar uma propriedade que pode ser usada em todos os DependencyObject tipos, em seguida, você deve criar uma propriedade anexada. Para saber mais sobre propriedades anexadas, incluindo como criá-los, consulte visão geral de propriedades anexado.

<object property="dependencyPropertyName"/>
- or -
<object property="ownerType.dependencyPropertyName"/>
- or -
<object property="attachedPropertyOwnerType.attachedPropertyName"/>

dependencyPropertyName

Uma cadeia de caracteres que especifica o DependencyProperty.Name da propriedade de dependência desejado. Isso pode ser precedido por um prefixo de namespace XML, se a propriedade não está no namespace XML padrão (para obter detalhes, consulte Namespaces XAML e o mapeamento de Namespace para WPF XAML.)

ownerType.dependencyPropertyName

Uma cadeia de caracteres que especifica um tipo de proprietário de uma propriedade de dependência, um ponto (.), então o DependencyProperty.Name. ownerTypetambém pode ser precedido por um prefixo de namespace XML. Esse uso é específico para estilos de associação tardia e modelos, em que o proprietário da propriedade de dependência deve ser especificado para analisar o contexto porque o TargetType ainda não é conhecido. Para obter mais informações, consulte Estilo e modelagem.

attachedPropertyOwnerType.attachedPropertyName

Uma cadeia de caracteres que especifica o proprietário de uma propriedade anexada, um ponto (.), o nome da propriedade anexada. attachedPropertyOwnerTypetambém pode ser precedido por um prefixo de namespace XML.

.NET Framework
Disponível desde 3.0
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: