DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue DependencyObject.SetValue Method

定義

依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property.

オーバーロード

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property, specified by its dependency property identifier.

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property, specified by its dependency property identifier.

public:
 void SetValue(System::Windows::DependencyProperty ^ dp, System::Object ^ value);
public void SetValue (System.Windows.DependencyProperty dp, object value);
member this.SetValue : System.Windows.DependencyProperty * obj -> unit
Public Sub SetValue (dp As DependencyProperty, value As Object)

パラメーター

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

設定する依存関係プロパティの識別子。The identifier of the dependency property to set.

value
Object Object Object Object

新しいローカル値。The new local value.

例外

読み取り専用の依存関係プロパティ、またはシールされている DependencyObject 上のプロパティを変更しようとしました。Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.

value が、dp プロパティに登録されている正しい型ではありません。value was not the correct type as registered for the dp property.

注釈

指定された型が最初に登録されているように、依存関係プロパティの宣言されている型が一致しない場合、例外がスローされます。If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value常に適切な型としてパラメーターを指定する必要があります。The value parameter should always be provided as the appropriate type.

例外条件によって決まる可能性のある、ValidateValueCallback設定される依存関係プロパティの依存関係プロパティの識別子上に存在するコールバック。The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set. それ以外の場合、指定された値に (たとえば、ネイティブ型は Double と文字列を渡すなど) の一般的な型チェックの状態を失敗する可能性があります。Otherwise, the value provided might be failing general type-checking conditions (for example, passing a string when the native type is Double).

SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

public:
 void SetValue(System::Windows::DependencyPropertyKey ^ key, System::Object ^ value);
public void SetValue (System.Windows.DependencyPropertyKey key, object value);
member this.SetValue : System.Windows.DependencyPropertyKey * obj -> unit
Public Sub SetValue (key As DependencyPropertyKey, value As Object)

パラメーター

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

設定するプロパティの DependencyPropertyKey 識別子。The DependencyPropertyKey identifier of the property to set.

value
Object Object Object Object

新しいローカル値。The new local value.

次の例では、読み取り専用の依存関係プロパティを定義と共に、 public static readonly DependencyPropertyプロパティのコンシューマーとの get アクセサーに必要な読み取り専用の露出を提供する、CLRCLRラッパー。The following example defines a read-only dependency property, along with a public static readonly DependencyProperty that provides necessary read-only exposure to property consumers, and the get accessor for the CLRCLR wrapper.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

注釈

この署名は通常、カスタム クラスで定義されている読み取り専用の依存関係プロパティの値を設定するときに使用します。This signature is generally used when you set values for read-only dependency properties that are defined by your custom classes. 一般に、SetValue依存関係プロパティの特定の値を提供する内部ロジックを実装して、その依存関係プロパティを登録する型からのみ呼び出されます。Generally, SetValue is called only from the type that registered that dependency property, which implements the internal logic that provides the determined value for the dependency property. 詳細については、「読み取り専用の依存関係プロパティ」を参照してください。For more information, see Read-Only Dependency Properties.

指定された型が最初に登録されているように、依存関係プロパティの宣言されている型が一致しない場合、例外がスローされます。If the provided type does not match the type that is declared for the dependency property as it was originally registered, an exception is thrown. value常に適切な型としてパラメーターを指定する必要があります。The value parameter should always be provided as the appropriate type. 例外条件によって決まる可能性のある、ValidateValueCallback設定される依存関係プロパティの依存関係プロパティの識別子上に存在するコールバック。The exception conditions are potentially influenced by the ValidateValueCallback callback that exists on the dependency property identifier of the dependency property being set.

適用対象