DependencyProperty Classe

Definição

Aviso

Esta API agora é obsoleta.

Um tipo especial de propriedade que pode ser definido ou anexado a um DependencyObject.A special kind of property that can be defined or attached to a DependencyObject. Há três tipos de propriedades de dependência: propriedades de instância, metapropriedades e propriedades anexadas.There are three kinds of dependency properties: instance properties, meta properties, and attached properties. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class DependencyProperty sealed : System::Runtime::Serialization::ISerializable
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
[System.Serializable]
public sealed class DependencyProperty : System.Runtime.Serialization.ISerializable
type DependencyProperty = class
    interface ISerializable
Public NotInheritable Class DependencyProperty
Implements ISerializable
Herança
DependencyProperty
Atributos
Implementações

Exemplos

O exemplo a seguir mostra como registrar um DependencyProperty para uso por um DependencyObject.The following example shows how to register a DependencyProperty for use by a DependencyObject. Este exemplo de código faz parte do exemplo de SDK de envio de email e é do arquivo SendMailActivity.cs.This code example is part of the Send Email SDK sample and is from the SendMailActivity.cs file. Para obter mais informações, consulte Enviar atividade de email.For more information, see Send Mail Activity.

// Define the DependencyProperty objects for all of the Properties 
// ...and Events exposed by this activity
public static DependencyProperty FromProperty = DependencyProperty.Register("From", typeof(string), typeof(SendEmailActivity), new PropertyMetadata("someone@example.com"));
public static DependencyProperty ToProperty = DependencyProperty.Register("To", typeof(string), typeof(SendEmailActivity), new PropertyMetadata("someone@example.com"));
' Define the DependencyProperty objects for all of the Properties 
' ...and Events exposed by me activity
Public Shared FromEmailProperty As DependencyProperty = DependencyProperty.Register("From", GetType(String), GetType(SendEmailActivity), New PropertyMetadata("someone@example.com"))
Public Shared ToProperty As DependencyProperty = DependencyProperty.Register("To", GetType(String), GetType(SendEmailActivity), New PropertyMetadata("someone@example.com"))

Comentários

Observação

Este material discute tipos e namespaces obsoletos.This material discusses types and namespaces that are obsolete. Para obter mais informações, consulte Deprecated Types in Windows Workflow Foundation 4.5 (Tipos preteridos no Windows Workflow Foundation 4.5).For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

As propriedades de dependência dão suporte a três casos de uso.Dependency properties support three use cases. Primeiro, se uma propriedade de instância de uma atividade for implementada usando uma propriedade de dependência, essa propriedade poderá ser ActivityBind atribuída a um em vez de um valor real.First, if an instance property of an activity is implemented by using a dependency property, that property can be assigned an ActivityBind instead of an actual value. Segundo, as propriedades de atividade que são metadados (ou seja, o valor não pode ser alterado em tempo de execução) devem ser implementadas usando Metadata Propriedades de dependência, especificando a opção.Second, activity properties that are metadata (that is, the value cannot change at run time) should be implemented by using dependency properties, specifying the Metadata option. Terceiro, as propriedades de dependência dão suporte a propriedades anexadas, que são propriedades que são aplicadas a objetos de dependência dinamicamente.Third, dependency properties support attached properties, which are properties that are applied to dependency objects dynamically.

Propriedades

DefaultMetadata

Obtém o PropertyMetadata que representa os dados definidos pelo usuário para este DependencyProperty.Gets the PropertyMetadata that represents user-defined data for this DependencyProperty.

IsAttached

Obtém a propriedade que indica se este DependencyProperty está associado a um DependencyObject por registro.Gets the property that indicates whether this DependencyProperty is associated to a DependencyObject by registration.

IsEvent

Obtém um valor que indica se o DependencyProperty é um Delegate de evento.Gets the property that indicates whether the DependencyProperty is an event Delegate.

Name

Obtém o Name do DependencyProperty.Gets the Name of the DependencyProperty.

OwnerType

Obtém o Type do DependencyProperty.Gets the Type of the DependencyProperty.

PropertyType

Obtém o Type do valor armazenado no DependencyProperty.Gets the Type of the value stored in the DependencyProperty.

ValidatorType

Obtém a lógica de validação de implementação de Type específica para a DependencyProperty.Gets the Type implementing validation logic specific to the DependencyProperty.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FromName(String, Type)

Obtém o DependencyProperty registrado com base no Name e no OwnerType.Gets the registered DependencyProperty based on the Name and OwnerType.

FromType(Type)

Cria um IList do tipo DependencyProperty que pertence a um Type específico.Creates an IList of type DependencyProperty that belong to a specific Type.

GetHashCode()

Retorna o código hash para essa instância.Returns the hash code for this instance.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Register(String, Type, Type)

Inicializa uma nova instância da classe DependencyProperty que tem as propriedades parametrizadas de acordo com os parâmetros de entrada.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

Register(String, Type, Type, PropertyMetadata)

Inicializa uma nova instância da classe DependencyProperty que tem as propriedades parametrizadas de acordo com os parâmetros de entrada.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

RegisterAttached(String, Type, Type)

Inicializa uma nova instância da classe DependencyProperty que tem as propriedades parametrizadas de acordo com os parâmetros de entrada.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters. Esta instância destina-se a declarar propriedades que são usadas em objetos que não são os do tipo proprietário.This instance is intended to declare properties that are used on objects other than the objects of owning type.

RegisterAttached(String, Type, Type, PropertyMetadata)

Inicializa uma nova instância da classe DependencyProperty que tem as propriedades parametrizadas de acordo com os parâmetros de entrada.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

RegisterAttached(String, Type, Type, PropertyMetadata, Type)

Inicializa uma nova instância da classe DependencyProperty que tem as propriedades parametrizadas de acordo com os parâmetros de entrada.Initializes a new instance of the DependencyProperty class that has the properties parameterized according to the input parameters.

ToString()

Substitui o método Object para retornar o valor da propriedade Name.Overrides the Object method to return the Name property value.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.Populates a SerializationInfo with the data required to serialize the target object.

Aplica-se a