DependencyProperty.Register Método

Definição

Espaço de Nomes:: System.Windows

Assemblagem:: WindowsBase.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Regista uma propriedade de dependência.

Sobrecargas

Name	Description
Register(String, Type, Type)	Regista uma propriedade de dependência com o nome de propriedade especificado, tipo de propriedade e tipo de proprietário.
Register(String, Type, Type, PropertyMetadata)	Regista uma propriedade de dependência com o nome da propriedade especificado, tipo de propriedade, tipo de proprietário e metadados da propriedade.
Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Regista uma propriedade de dependência com o nome especificado, tipo de propriedade, tipo de proprietário, metadados da propriedade e um callback de validação de valor para a propriedade.

Register(String, Type, Type)

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

public:
 static System::Windows::DependencyProperty ^ Register(System::String ^ name, Type ^ propertyType, Type ^ ownerType);

public static System.Windows.DependencyProperty Register(string name, Type propertyType, Type ownerType);

static member Register : string * Type * Type -> System.Windows.DependencyProperty

Public Shared Function Register (name As String, propertyType As Type, ownerType As Type) As DependencyProperty

Parâmetros

name: String

O nome da propriedade de dependência a registar. O nome deve ser único dentro do espaço de registo do tipo de proprietário.

propertyType: Type

O tipo de propriedade.

ownerType: Type

O tipo de proprietário que está a registar a propriedade de dependência.

Devoluções

DependencyProperty

Um identificador de propriedade de dependência que deve ser usado para definir o valor de um public static readonly campo na sua classe. Esse identificador é então usado para referenciar a propriedade de dependência mais tarde, para operações como definir o seu valor programaticamente ou obter metadados.

Exemplos

public static readonly DependencyProperty IsDirtyProperty = DependencyProperty.Register(
  "IsDirty",
  typeof(Boolean),
  typeof(AquariumObject3)
);

Public Shared ReadOnly IsDirtyProperty As DependencyProperty = DependencyProperty.Register("IsDirty", GetType(Boolean), GetType(AquariumObject3))

Observações

Para mais informações sobre o registo de propriedades por dependência, consulte DependencyProperty.

Ver também

Aplica-se a

Register(String, Type, Type, PropertyMetadata)

Regista uma propriedade de dependência com o nome da propriedade especificado, tipo de propriedade, tipo de proprietário e metadados da propriedade.

public:
 static System::Windows::DependencyProperty ^ Register(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ typeMetadata);

public static System.Windows.DependencyProperty Register(string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata typeMetadata);

static member Register : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty

Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty

Parâmetros

name: String

O nome da propriedade de dependência a registar.

propertyType: Type

O tipo de propriedade.

ownerType: Type

O tipo de proprietário que está a registar a propriedade de dependência.

typeMetadata: PropertyMetadata

Metadados da propriedade para a propriedade de dependência.

Devoluções

DependencyProperty

Observações

Para mais informações sobre o registo de propriedades por dependência, consulte DependencyProperty.

Ver também

Aplica-se a

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

Regista uma propriedade de dependência com o nome especificado, tipo de propriedade, tipo de proprietário, metadados da propriedade e um callback de validação de valor para a propriedade.

public:
 static System::Windows::DependencyProperty ^ Register(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ typeMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);

public static System.Windows.DependencyProperty Register(string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata typeMetadata, System.Windows.ValidateValueCallback validateValueCallback);

static member Register : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyProperty

Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyProperty

Parâmetros

name: String

O nome da propriedade de dependência a registar.

propertyType: Type

O tipo de propriedade.

ownerType: Type

O tipo de proprietário que está a registar a propriedade de dependência.

typeMetadata: PropertyMetadata

Metadados da propriedade para a propriedade de dependência.

validateValueCallback: ValidateValueCallback

Uma referência a um callback que deve realizar qualquer validação personalizada do valor da propriedade de dependência para além da validação típica de tipos.

Devoluções

DependencyProperty

Exemplos

O exemplo seguinte regista uma propriedade de dependência, incluindo um callback de validação (a definição de callback não é mostrada; para detalhes sobre a definição de callback, veja ValidateValueCallback).

public static readonly DependencyProperty CurrentReadingProperty = DependencyProperty.Register(
    "CurrentReading",
    typeof(double),
    typeof(Gauge),
    new FrameworkPropertyMetadata(
        Double.NaN,
        FrameworkPropertyMetadataOptions.AffectsMeasure,
        new PropertyChangedCallback(OnCurrentReadingChanged),
        new CoerceValueCallback(CoerceCurrentReading)
    ),
    new ValidateValueCallback(IsValidReading)
);
public double CurrentReading
{
  get { return (double)GetValue(CurrentReadingProperty); }
  set { SetValue(CurrentReadingProperty, value); }
}

Public Shared ReadOnly CurrentReadingProperty As DependencyProperty =
    DependencyProperty.Register("CurrentReading",
        GetType(Double), GetType(Gauge),
        New FrameworkPropertyMetadata(Double.NaN,
            FrameworkPropertyMetadataOptions.AffectsMeasure,
            New PropertyChangedCallback(AddressOf OnCurrentReadingChanged),
            New CoerceValueCallback(AddressOf CoerceCurrentReading)),
        New ValidateValueCallback(AddressOf IsValidReading))

Public Property CurrentReading() As Double
    Get
        Return CDbl(GetValue(CurrentReadingProperty))
    End Get
    Set(ByVal value As Double)
        SetValue(CurrentReadingProperty, value)
    End Set
End Property

Observações

Para mais informações sobre o registo de propriedades por dependência, consulte DependencyProperty.

Ver também

Aplica-se a

Comentários

Esta página foi útil?